Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-File
                      The ob_flags field of an OBJECT
                               (Object Flags)


The ob_flags field of the OBJECT structure is a bitmask of different
flags that can be applied to any object as follows:

Name        Bit(s)  Mask     Meaning

SELECTABLE    0     0x0001   Object's selected state may be toggled by
                             clicking on it with the mouse.

DEFAULT       1     0x0002   An EXIT object with this bit set will have
                             a thicker outline and be triggered when the
                             user presses return.

EXIT          2     0x0004   Clicking on this OBJECT and releasing the
                             mouse button while still over it will cause
                             the dialog to exit.

EDITABLE      3     0x0008   Set for FTEXT and FBOXTEXT objects to
                             indicate that they may receive edit focus.

RBUTTON       4     0x0010   This object is one of a group of radio
                             buttons. Clicking on it will deselect any
                             selected objects at the same tree level that
                             also have the RBUTTON flag set. Likewise, it
                             will be deselected automatically when any
                             other object is selected.

LASTOB        5     0x0020   This flag signals to the AES that the current
                             OBJECT is the last in the object tree.
                             (Required!)

TOUCHEXIT     6     0x0040   Setting this flag causes the OBJECT to return
                             an exit state immediately after being clicked
                             on with the mouse.

HIDETREE      7     0x0080   This OBJECT and all of its children will not
                             be drawn.

INDIRECT      8     0x0100   This flag cause the ob_spec field to be
                             interpreted as a pointer to the ob_spec value
                             rather than the value itself.

FL3DIND       9     0x0200   Setting this flag causes the OBJECT to be
                             drawn as a 3D indicator. This is appropriate
                             for radio and toggle buttons. This flag is
                             only recognized as of AES version 3.4.

FL3DACT       10    0x0400   Setting this flag causes the OBJECT to be
                             drawn as a 3D activator. This is appropriate
                             for EXIT buttons. This flag is only
                             recognized as of AES version 3.4.

FL3DBAK     9 & 10  0x0600   If these bits are set, the object is treated
                             as an AES background object. If it is
                             OUTLINED, the outlined is drawn in a 3D
                             manner. If its color is set to WHITE and its
                             fill pattern is set to 0 then the OBJECT will
                             inherit the default 3D background color. This
                             flag is only recognized as of AES version
                             3.4.

SUBMENU       11    0x0800   This bit is set on menu items which have
                             a sub-menu attachment. This bit also
                             indicates that the high byte of the ob_type
                             field is being used by the menu system.