TABLE OF CONTENTS getscreenmode.gadget/--datasheet-- getscreenmode.gadget/GETSCREENMODE_GetClass getscreenmode.gadget/GSM_REQUEST getscreenmode.gadget/--datasheet-- getscreenmode.gadget/--datasheet-- NAME getscreenmode.gadget -- Create getscreenmode BOOPSI objects SUPERCLASS gadgetclass REQUIRES button.gadget DESCRIPTION The getscreenmode gadget class is used to get screenmodes from a screenmode requester in an easy and consistent way. It consists of two button gadgets, one read-only and one popscreenmode button, that are used to select the screenmode and show the result. METHODS OM_NEW -- Passed to superclass, defaults set, then OM_SET. OM_SET -- Passed to superclass, custom tags set. OM_GET -- Custom tag returned or passed to superclass. OM_UPDATE -- Passed to superclass, options set then rendered. OM_DISPOSE -- Private data disposed of then passed to superclass. GM_RENDER -- Passed to superclass then rendered. GM_HITTEST -- Overrides superclass, returns GMR_GADGETHIT if within the popscreenmode button. GM_HELPTEST -- Overrides superclass, returns GMR_HELPHIT if within the domain of the gadget. GM_GOACTIVE -- Passed to superclass, passed to popup button. GM_HANDLEINPUT -- Overrides superclass, all input processed. GM_GOINACTIVE -- Passed to superclass, popup button deactivated. GM_DOMAIN -- Returns GDOMAIN_MINIMUM, GDOMAIN_NOMINAL and GDOMAIN_MAXIMUM dimensions. GM_LAYOUT -- Calculate relative gadget coordinates. GM_EXTENT -- Reports gadget rendering extent. GM_CLIPRECT -- Installs ClipRect for virtual group support. GM_KEYGOACTIVE -- Handle keyboard activation. (V53.2) GM_KEYGOINACTIVE -- Handle keyboard deactivation. (V53.2) GSM_REQUEST -- Invokes the screenmode requester. ATTRIBUTES Many of these tags operate the same as the ASLSM_#? tags in ASL library. See for detailed descriptions. GA_HintInfo (CONST_STRPTR) Specify the text to use as the hint info for this gadget. You can change this attribute at any time, and it will over- ride any text specified in the windows HintInfo array. See window.class autodoc for more information. Defaults to NULL. Applicability is (OM_NEW, OM_SET). GETSCREENMODE_TitleText (CONST_STRPTR) Title of the screenmode requester. Defaults to none. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_Height (int16) Height of the screenmode requester. Defaults to ~0. Applicability is (OM_NEW, OM_SET, OM_GET) GETSCREENMODE_Width (int16) Width of the screenmode requester. Defaults to ~0. Applicability is (OM_NEW, OM_SET, OM_GET) GETSCREENMODE_LeftEdge (int16) Left edge of the screenmode requester. Defaults to ~0. Applicability is (OM_NEW, OM_SET, OM_GET) GETSCREENMODE_TopEdge (int16) Top edge of the screenmode requester. Defaults to ~0. Applicability is (OM_NEW, OM_SET, OM_GET) GETSCREENMODE_DisplayID (uint32) Display id of screenmode. Defaults to 0 (LORES_KEY). Applicability is (OM_NEW, OM_SET, OM_GET, OM_NOTIFY) GETSCREENMODE_DisplayWidth (uint32) Display width. Defaults to 640. Applicability is (OM_NEW, OM_SET, OM_GET, OM_NOTIFY) GETSCREENMODE_DisplayHeight (uint32) Display height. Defaults to 200. Applicability is (OM_NEW, OM_SET, OM_GET, OM_NOTIFY) GETSCREENMODE_DisplayDepth (uint16) Display depth. Defaults to 2. Applicability is (OM_NEW, OM_SET, OM_GET, OM_NOTIFY) GETSCREENMODE_OverscanType (uint16) Type of overscan. Defaults to OSCAN_TEXT. Applicability is (OM_NEW, OM_SET, OM_GET, OM_NOTIFY) GETSCREENMODE_AutoScroll (BOOL) Autoscroll setting. Defaults to TRUE. Applicability is (OM_NEW, OM_SET, OM_NOTIFY) GETSCREENMODE_InfoOpened (BOOL) Info window initially opened? Defaults to FALSE. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_InfoLeftEdge (int16) Info window left edge. Defaults to 30. Applicability is (OM_NEW, OM_SET, OM_GET) GETSCREENMODE_InfoTopEdge (int16) Info window top edge. Defaults to 20. Applicability is (OM_NEW, OM_SET, OM_GET) GETSCREENMODE_DoWidth (BOOL) Display Width gadget? Defaults to FALSE. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_DoHeight (BOOL) Display Height gadget? Defaults to FALSE. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_DoDepth (BOOL) Display Depth gadget? Defaults to FALSE. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_DoOverscanType (BOOL) Display Overscan Type gadget? Defaults to FALSE. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_DoAutoScroll (BOOL) Display AutoScroll gadget? Defaults to FALSE. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_PropertyFlags (uint32) Must have these Property flags. Defaults to DIPF_IS_WB. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_PropertyMask (uint32) Only these should be looked at. Defaults to DIPF_IS_WB. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_MinWidth (uint32) Minimum display width to allow. Defaults to 16. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_MaxWidth (uint32) Maximum display width to allow. Defaults to 16368. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_MinHeight (uint32) Minimum display height to allow. Defaults to 16. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_MaxHeight (uint32) Maximum display height to allow. Defaults to 16368. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_MinDepth (uint32) Minimum display depth to allow. Defaults to 1. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_MaxDepth (uint32) Maximum display depth to allow. Defaults to 24. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_FilterFunc (struct Hook *) Function to filter mode id's. Defaults to none. Applicability is (OM_NEW, OM_SET) GETSCREENMODE_CustomSMList (struct List *) Exec list of struct DisplayMode. Defaults to none. Applicability is (OM_NEW, OM_SET) getscreenmode.gadget/GETSCREENMODE_GetClassmode.gadget/GETSCREENMODE_GetClass NAME GETSCREENMODE_GetClass -- Gets pointer to the getscreenmode class. SYNOPSIS Class * class = GETSCREENMODE_GetClass(); FUNCTION This function is deprecated as of V52. Use the "getscreenmode.gadget" public class ID instead. RESULT class - Pointer to the getscreenmode class. getscreenmode.gadget/GSM_REQUEST getscreenmode.gadget/GSM_REQUEST NAME GSM_REQUEST -- Invokes the screenmode requester. SYNOPSIS uint32 result = IDoMethodA(APTR obj, struct gsmRequest* msg); FUNCTION Opens the screenmode requester and blocks the given window. When the user has finished making adjustments the selection details are sent via the OM_NOTIFY mechanism. All the attributes marked with OM_NOTIFY are sent to the receiver. INPUTS obj - getscreenmode object pointer msg - pointer to fully initialized struct gsmRequest (see ) RESULT Returns non-zero on success or 0 on failure.