[Contents] [index] [Help] [Retrace] [browse <] [Browse >]

These flags may be set in the activation field of the gadget structure.

GACT_TOGGLESELECT
    This flag applies only to boolean gadgets, and tells intuition that
    this is to be a toggle-select gadget, not a hit-select one.  Preset
    the selection state with the gadget flag gflg_selected (see above).
    The program may check if the gadget is in the selected state by
    examining the GFLG_SELECTED flag at any time.

GACT_IMMEDIATE
    If this bit is set, the program will be sent an idcmp_gadgetdown
    message when the gadget is first picked.  The message will be sent
    when the user presses the mouse select button.

GACT_RELVERIFY
    This is short for "release verify."  If this bit is set, the program
    will be sent an idcmp_gadgetup message when the gadget is
    deactivated.  IDCMP_GADGETUP will be sent for boolean gadgets when
    the user releases the mouse select button while the pointer is over
    the select box, for proportional gadgets whenever the user releases
    the mouse select button (regardless of the pointer position), and for
    string and integer gadgets when the user completes the text entry by
    pressing return or tabbing to the next gadget (where supported).

    For boolean gadgets, if the user releases the mouse button while the
    pointer is outside of the gadget's select box idcmp_gadgetup will not
    be generated.  Instead, the program will receive an
    idcmp_mousebuttons event with the selectup code set.  for string
    gadgets, if the user deactivates the gadget by clicking elsewhere, it
    may not be possible to detect.

GACT_ENDGADGET
    This flag pertains only to gadgets attached to requesters.  If a
    gadget with the GACT_ENDGADGET flag set is chosen by the user the
    requester will be terminated as if the application had called the
    endrequest() function.

    See the chapter "intuition requesters and alerts," for more
    information about requester gadget considerations.

GACT_FOLLOWMOUSE
    These flags may be set in the activation field of the gadget
    structure. As long as a gadget that has this flag set is active, the
    program will receive mouse position messages for each change of mouse
    position.  For gtyp_boolgadget gadgets, gact_relverify must also be
    set for the program to receive mouse events.


The following flags are used to place application gadgets into a specified
window border.  Intuition will adjust the size of a window's borders
appropriately provided these gadgets are set up with a call to
openwindow(), openwindowtags() or openwindowtaglist().  intuition knows to
refresh gadgets marked with these flags when the window border is changed,
e.g., when the window is activated.  For gimmezerozero windows, the
gtyp_gzzgadget flag must also be set for border gadgets.

GACT_RIGHTBORDER
    If this flag is set, the gadget is placed in the right border of the
    window and the width and position of this gadget are used in deriving
    the width of the window's right border.

GACT_LEFTBORDER
    If this flag is set, the gadget is placed in the left border of the
    window and the width and position of this gadget are used in deriving
    the width of the window's left border.

GACT_TOPBORDER
    If this flag is set, the gadget is placed in the top border of the
    window and the height and position of this gadget are used in
    deriving the height of the window's top border.

GACT_BOTTOMBORDER
    If this flag is set, the gadget is placed in the bottom border of the
    window and the height and position of this gadget are used in
    deriving the height of the window's bottom border.


The following flags apply only to string gadgets:

GACT_STRINGCENTER
    If this flag is set, the text in a string gadget is centered within
    the select box.

GACT_STRINGRIGHT
    If this flag is set, the text in a string gadget is right justified
    within the select box.

GACT_STRINGLEFT
    This "flag" has a value of zero.  By default, the text in a string
    gadget is left justified within the select box.

GACT_LONGINT
    If this flag is set, the user can construct a 32-bit signed integer
    value in a normal string gadget. the input buffer of the string
    gadget must be initialized with an ASCII representation of the
    starting integer value.

GACT_ALTKEYMAP
    These flags may be set in the activation field of the gadget
    structure.  A pointer to the keymap must be placed in the stringinfo
    structure variable altkeymap.

GACT_BOOLEXTEND
    This flag applies only to boolean gadgets.  if this flag is set, then
    the boolean gadget has a boolinfo structure associated with it.  a
    pointer to the BoolInfo structure must be placed in the specialinfo
    field of the gadget structure.

GACT_STRINGEXTEND
    This is an obsolete flag originally defined in V36.  It applies only
    to string gadgets and indicates that stringinfo.extension points to a
    valid stringextend structure.  although this flag works, it is not
    ignored prior to V36 as it should be in order to be backward
    compatible.  This flag is replaced by gflg_stringextend in v37.
    GFLG_STRINGEXTEND performs the same function and is properly ignored
    on systems prior to V36.