Newer
Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
module Fox
#
# A Check button is a tri-state button. Normally, it is either
# +TRUE+ or +FALSE+, and toggles between +TRUE+ or +FALSE+ whenever it is pressed.
# A third state +MAYBE+ may be set to indicate that no selection has been made yet
# by the user, or that the state is ambiguous.
# When pressed, the Check Button sends a <tt>SEL_COMMAND</tt> to its target, and the
# message data represents the state of the check button.
# The option <tt>CHECKBUTTON_AUTOGRAY</tt> (<tt>CHECKBUTTON_AUTOHIDE</tt>) causes the button to be
# grayed out (hidden) if its handler does not respond to the <tt>SEL_UPDATE</tt> message.
# With the <tt>CHECKBUTTON_PLUS</tt> option, the Check Button will draw a + or - sign instead
# of a check. You can use this to make collapsible panels, by hooking up a Check
# Button to a layout manager via the <tt>ID_TOGGLE_SHOWN</tt> message. This will give a
# similar visual element as collapsing folders in a Tree List.
#
# === Events
#
# The following messages are sent by FXCheckButton 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.
#
# === CheckButton styles
#
# +CHECKBUTTON_AUTOGRAY+:: Automatically gray out when not updated
# +CHECKBUTTON_AUTOHIDE+:: Automatically hide when not updated
# +CHECKBUTTON_PLUS+:: Draw a plus sign for unchecked and minus sign for checked
# +CHECKBUTTON_NORMAL+:: <tt>JUSTIFY_NORMAL|ICON_BEFORE_TEXT</tt>
class FXCheckButton < FXLabel
# Check button state (+TRUE+, +FALSE+ or +MAYBE+) [Integer]
attr_accessor :checkState
# Check button style [Integer]
attr_accessor :checkButtonStyle
# Box background color [FXColor]
attr_accessor :boxColor
# Box check color [FXColor]
attr_accessor :checkColor
# Construct new check button
def initialize(parent, text, target=nil, selector=0, opts=CHECKBUTTON_NORMAL, x=0, y=0, width=0, height=0, padLeft=DEFAULT_PAD, padRight=DEFAULT_PAD, padTop=DEFAULT_PAD, padBottom=DEFAULT_PAD) # :yields: theCheckButton
end
#
# Set the check button state to one of +TRUE+, +FALSE+ or +MAYBE+.
# If _notify_ is +true+, send a +SEL_COMMAND+ message to the message target
# after the state has been updated.
#
def setCheck(state, notify=false); end
end
end