CHECKBOX

Syntax

ctl[n]: CHECKBOX(Class Specific Properties), Other Properties

Description

The checkbox acts as a toggle for two or three states. You should use this control when the user has a choice of enabling or disabling some function (eg disabling previewing, enabling a part of your filter's algorithm). The three state option should be used when the state can become "partially enabled". A common use for checkboxes is to toggle between horizontal and vertical orientation, for example in a blurring, or scanline filter.

Class Specific Properties

3STATE
Allows the checkbox to returns one of three values (third state is a grayed check)
BORDER
Draws a border around the checkbox.
BOTTOM
Aligns text at the bottom of the checkbox's text area.
CENTER
Centers text within the checkbox's text area.
CLIENTEDGE
Draws a 3D-border around the checkbox.
FLAT
Gives the checkbox a flat, 2D appearance.
LEFT
Left-aligns text within the checkbox's text area. (default)
LEFTTEXT
Places the text label on the left of the checkbox (same as RIGHTBUTTON).
MODALFRAME
Draws a 3D-socket around the checkbox.
MULTILINE
Allows word-wrapping within the checkbox's text area.
PUSHLIKE
Makes the checkbox appear as a depressable pushbutton.
RIGHT
Right-aligns text within the checkbox's text area.
RIGHTBUTTON
Places the text label on the left of the checkbox (same as LEFTTEXT).
STATICEDGE
Draws a 3D-border around the checkbox.
TOP
Aligns text at the top of the checkbox's text area.
VCENTER
Vertically-centers text within the checkbox's text area.

Other Properties

Color
Sets text background color in plain English format (default = transparent)
FontColor
Sets font color in hexadecimal format (default = #FFFFFF)
Text
Defines the text label next to the checkbox (default = no text)

Example

ctl[5]: CHECKBOX, "Horizontal/Vertical Lines", FontColor=Darkblue
ctl[7]: CHECKBOX(3STATE), "White/Black/Gray"

Notes

If you are using the class-specific property 3STATE , these are the values a function like ctl(n) returns (also applies if the class-specific property PUSHLIKE is defined):
0 not checked
1 checked (black check in the checkbox)
2 checked (gray check in the checkbox)
There is a bug in Windows XP that causes checkboxes to show a black background, even if a background image hasn't been defined for the dialog. Currently, the only solution is to use the Pushlike property, define another color using the Color property, or simulate a checkbox using your own code and bitmaps.