The SpeedButton class is derived from the
Control class and has the ability to show
an image in addition to the caption.
access function : GetSpeedButton(name)
Additional attributes of the SpeedButton class
Attribute |
Access |
Type |
Description |
caption |
R/W |
string |
the button caption (normally empty for
SpeedButtons) |
layout |
R/W |
int |
the glyph position, Left=0, Right=1, Top=2,
Bottom=3 |
margin |
R/W |
int |
image margin to control boundaries. Default=-1 -
windows default |
flat |
R/W |
bool |
flat style or not |
down |
R/W |
bool |
button stays down when true if groupIndex<>0 |
groupIndex |
R/W |
int |
buttons may be grouped by groupIndex. Only one
button in same group may be down at the same time. |
allowAllUp |
T/W |
bool |
fgroupedlat wheter buttons in same group can all
be up |
font |
R |
font |
the captions font object |
glyphName |
W |
string |
filename of BMP file to show |
numGlyphs |
R/W |
int |
number of "glyphs" in bitmap. A button bitmap
may contain 1 to 4 glyphs to indicate button state, Enabled (1),
Disabled (2), Checked (3) and Unchecked (4). A bitmap of
multiple glyhps must have a width of of 2, 3 or 4 times actual
width of one glyph as it is splitted equally due to numGlyphs. |
onClick |
W |
callback |
called when user clicks the control |
Note: SpeedButtons may be grouped by setting equal groupIndex. Only
one button may stay down at a time in the same group. To have a
button toggle as a state button, set the groupIndex<>0 and toggle
the down due to state. Set allowUp for buttons in same group if none
of the buttons may be down. |