Unit 'cybergraphics'	Package
[Overview][Constants][Types][Procedures and functions][Variables][Index]	[#os4units]

CModeRequestTagList

Get screenmode from user using a requester.

Declaration

Source position: cybergraphics.pas line 157

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.