User Guide

CheckBox component 159
Customizing the CheckBox component
You can transform a CheckBox component horizontally and vertically while authoring and at
runtime. While authoring, select the component on the Stage and use the Free Transform tool or
any of the Modify > Transform commands. At runtime, use the
setSize() method
(
UIObject.setSize()) or any applicable properties and methods of the CheckBox class.
Resizing the check box does not change the size of the label or the check box icon; it only changes
the size of the bounding box.
The bounding box of a CheckBox instance is invisible and also designates the hit area for the
instance. If you increase the size of the instance, you also increase the size of the hit area. If the
bounding box is too small to fit the label, the label is clipped to fit.
Using styles with the CheckBox component
You can set style properties to change the appearance of a CheckBox instance. If the name of a
style property ends in “Color”, it is a color style property and behaves differently than noncolor
style properties. For more information, see “Using styles to customize component color and text”
on page 67.
A CheckBox component supports the following styles:
Style Theme Description
themeColor
Halo The base color scheme of a component. Possible
values are
"haloGreen", "haloBlue", and
"haloOrange". The default value is "haloGreen".
color
Both The text color. The default value is 0x0B333C for the
Halo theme and blank for the Sample theme.
disabledColor
Both The color for text when the component is disabled.
The default color is 0x848384 (dark gray).
embedFonts
Both A Boolean value that indicates whether the font
specified in
fontFamily is an embedded font. This
style must be set to
true if fontFamily refers to an
embedded font. Otherwise, the embedded font will
not be used. If this style is set to
true and fontFamily
does not refer to an embedded font, no text will be
displayed. The default value is
false.
fontFamily
Both The font name for text. The default value is "_sans".
fontSize
Both The point size for the font. The default value is 10.
fontStyle
Both The font style: either "normal" or "italic". The default
value is
"normal".
fontWeight
Both The font weight: either "none" or "bold". The default
value is
"none". All components can also accept the
value
"normal" in place of "none" during a setStyle()
call, but subsequent calls to
getStyle() will return
"none".