CheckBox control
CheckBox controls are small square boxes used to set
independent options. When they are selected, they display a mark
(typically, either an X or a check mark). When they are not selected,
they are empty.
Since check boxes are independent of each other, you can group
them without affecting their behavior. Grouping check boxes makes
the window easier for the user to understand and use.
Typically, check boxes have two states: on and off. You can
also use a third state, unknown or unspecified. In the third state,
the check is grayed.
Properties
CheckBox |
Datatype |
Description |
---|---|---|
String |
A description of the control and/or |
|
String |
A label that briefly describes the control, |
|
AccessibleRole (enumerated) |
Describes what kind of user interface |
|
Boolean |
Specifies whether the control displays
|
|
Long |
Specifies the numeric value of the background |
|
BorderStyle (enumerated) |
Specifies the style of the border of
|
|
Boolean |
Specifies whether PowerBuilder moves
|
|
Boolean |
Specifies whether the control is selected.
|
|
ClassDefinition |
PowerObject |
An object of type PowerObject containing |
Boolean |
Specifies whether PowerBuilder puts the
|
|
String |
Specifies the name of the stock icon When the user drags the control, the icon displays when the control |
|
Boolean |
Specifies whether the control is enabled
|
|
String |
Specifies the name of the typeface in |
|
FontCharSet (enumerated) |
Specifies the font character set used |
|
FontFamily (enumerated) |
Specifies the font family (type style)
|
|
FontPitch (enumerated) |
Specifies the pitch (spacing) of the
|
|
Integer |
Specifies the height of the control, |
|
Boolean |
Specifies whether the text in the control
|
|
Boolean |
Specifies whether the text displays on
Typically, you set this property to false so |
|
String |
Specifies the name of the stock pointer |
|
RightToLeft |
Boolean |
Specifies that characters should be displayed
|
Integer |
Specifies the tab value of the control |
|
String |
Specifies the tag value assigned to the |
|
String |
Specifies the text that displays next |
|
Long |
Specifies the numeric value of the color |
|
Integer |
Specifies the size of the text in the |
|
Boolean |
Specifies whether the control is in the
|
|
Boolean |
Specifies whether the control has three
|
|
Boolean |
Specifies whether the text in the control
|
|
Boolean |
Specifies whether the control is visible.
|
|
Integer |
Specifies the stroke weight of the text |
|
Integer |
Specifies the width of the control, in |
|
Integer |
Specifies the X position (the distance |
|
Integer |
Specifies the Y position (the distance |
Events
CheckBox event |
Occurs |
---|---|
When the control is clicked (selected |
|
Immediately before the Open event occurs |
|
Immediately after the Close event occurs |
|
When a dragged control is dropped on |
|
When a dragged control enters the control |
|
When a dragged control leaves the control |
|
When a dragged control is within the |
|
Just before the control receives focus |
|
When the user presses the F1 key or drags |
|
When the control loses focus (becomes |
|
When a Windows message occurs that is |
|
When the right mouse button is pressed |
Functions
CheckBox |
Datatype |
Description |
---|---|---|
String |
Returns the name assigned to the control |
|
Integer |
Starts or ends the dragging of the control |
|
Integer |
Creates a reference to a context-specific |
|
PowerObject |
Returns a reference to the name of the |
|
Integer |
Makes the control invisible |
|
Integer |
Moves the control to a specified location |
|
Integer |
Returns the distance of the pointer from |
|
Integer |
Returns the distance of the pointer from |
|
Boolean |
Adds an event to the end of the message |
|
Integer |
Prints the control |
|
Integer |
Changes the size of the control |
|
Integer |
Sets focus to the control |
|
Integer |
Specifies the position of the control |
|
Integer |
Controls automatic redrawing of the control |
|
Integer |
Makes the control visible |
|
Integer |
Triggers a specified event in the control |
|
Object |
Returns the type of the control |