CModeRequestTagList
Get screenmode from user using a requester.
Declaration
Source position: cybergraphics.pas line 301
function CModeRequestTagList( |
ModeRequest: POINTER; |
ModeRequestTags: PTagItem |
):LongWord; |
Arguments
ModeRequest |
|
not used currently. You have to set it to nil! |
ModeRequestTags |
|
Pointer to an optional tag list which may be used to control features of the requester |
Function result
0 if the user cancelled the requester or if something prevented the requester from opening. If <> 0 the displaymode ID of the selected screenmode is returned.
Description
Prompts the user for input by showing all available CyberGraphX screenmodes in a requester. If the user cancels or the system aborts the request, 0 is returned, otherwise the displaymode ID of the selected screenmode.
Available Tags:
- CYBRMREQ_Screen
- (PScreen) Screen on which to open the requester. Default locale will be used.
- CYBRMREQ_WinTitle
- (PChar) Title to use for the requesting window.
- CYBRMREQ_OKText
- (PChar) Label of the positive gadget in the requester. English default is 'OK'.
- CYBRMREQ_CancelText
- (PChar) Label of the negative gadget in the requester. English default is 'Cancel'.
- CYBRMREQ_MinWidth
- (LongWord) The minimum display width to let the user choose. Default is 320.
- CYBRMREQ_MaxWidth
- (LongWord) The maximum display width to let the user choose. Default is 1600.
- CYBRMREQ_MinHeight
- (LongWord) The minimum display height to let the user choose. Default is 240.
- CYBRMREQ_MaxHeight
- (LongWord) The maximum display height to let the user choose. Default is 1200.
- CYBRMREQ_MinDepth
- (Word) The minimum display depth to let the user choose. Default is 8.
- CYBRMREQ_MaxDepth
- (Word) The maximum display depth to let the user choose. Default is 32.
- CYBRMREQ_CModelArray
- (PWord) Array of color models which should be available for screenmode selection. Currently supported colormodels are: PIXFMT_LUT8, PIXFMT_RGB15, PIXFMT_BGR15, PIXFMT_RGB15PC, PIXFMT_BGR15PC, PIXFMT_RGB16, PIXFMT_BGR16, PIXFMT_RGB16PC, PIXFMT_BGR16PC, PIXFMT_RGB24, PIXFMT_BGR24, PIXFMT_ARGB32, PIXFMT_BGRA32, PIXFMT_RGBA32 default is all colormodels available, nothing filtered
Errors
The requester structure is not supported. You should better use asl.library/AslRequest() instead.
See also