A button provides a push button, with optional icon and/or text label. When
pressed, the button widget sends a SEL_COMMAND to its target.
Passing the BUTTON_TOOLBAR style option gives buttons a
"flat" look, and causes the edge of the button to be raised when
the cursor moves over it. Passing BUTTON_DEFAULT allows the button
to become the default button in a dialog, when the focus moves to it. The
default widget in a dialog is the widget which will accept the
Return key when it is pressed. The BUTTON_INITIAL flag
makes the button the default widget when the focus moves to a widget which
can not itself be a default widget. There should be only a single button in
the dialog which is the initial default; typically this is the OK
or Close button. The option BUTTON_AUTOGRAY
(BUTTON_AUTOHIDE) causes the button to be grayed out (hidden) if
its handler does not respond to the SEL_UPDATE message. This is
useful when messages are delegated, for example when using a multiple
document interface, where the ultimate destination of a message can be
changed.
Events
The following messages are sent by FXButton to
its target:
SEL_KEYPRESS: | sent when a key goes down; the message data is an FXEvent instance.
|
SEL_KEYRELEASE: | sent when a key goes up; the message data is an FXEvent instance.
|
SEL_LEFTBUTTONPRESS: | sent when the left mouse button goes down; the message data is an FXEvent instance.
|
SEL_LEFTBUTTONRELEASE: | sent when the left mouse button goes up; the message data is an FXEvent instance.
|
SEL_COMMAND: | sent when the button is clicked.
|
Button state bits
STATE_UP: | Button is up
|
STATE_DOWN: | Button is down
|
STATE_ENGAGED: | Button is engaged
|
STATE_UNCHECKED: | Same as STATE_UP (used for check buttons or radio buttons)
|
STATE_CHECKED: | Same as STATE_ENGAGED (used for check buttons or radio buttons)
|
Button flags
BUTTON_AUTOGRAY: | Automatically gray out when not updated
|
BUTTON_AUTOHIDE: | Automatically hide button when not updated
|
BUTTON_TOOLBAR: | Toolbar style button [flat look]
|
BUTTON_DEFAULT: | May become default button when receiving focus
|
BUTTON_INITIAL: | This button is the initial default button
|
BUTTON_NORMAL: | Default button flags
(FRAME_RAISED|FRAME_THICK|JUSTIFY_NORMAL|ICON_BEFORE_TEXT)
|