Introduction to PowerBuilder

CheckBox

A CheckBox is used to select or deselect a given option. For example, you may want to find whether the user is employed or not? You can achieve this with the help of a Checkbox.

If required, a CheckBox can have a third state, which means either undecided or a mixed state. This option is activated by checking the control's "Three State" property.

A better example of the "Third State" property would be a part time job. This position is neither full time employment nor an un-employment.

"Checked/Third State": The default value of a CheckBox is Unchecked, but you can change this by selecting either Checked or "Third State" properties.

Selecting the "Three State" property allows the Checkbox to have three states and selecting the "Third State" property makes the "Third State" the default state.

"Left Text": The "Left Text" property displays the text to the left of the CheckBox. By default, the text display is on the right side and the Checkbox on the left side. Deselecting it reverses the order, placing the CheckBox on the left of the text.

"Automatic": By default, "Automatic" property is turned on. When this option is turned on, at run-time, the Checkbox automatically changes the state (checked/ un-checked/ third state) as the user clicks on the Checkbox control. If the option is not turned on, you need to change the state programmatically.

In version 6.0, this control supports 'Right to Left' property.

	Place a Checkbox control on the window.
	Turn on/off "Left Text" property and preview the window each time.
	Turn "Three State" property on/off , and preview the window each time and click on the control few times while previewing.
	Turn off the "Automatic" property and preview the window and click and see whether it will automatically change the status or not.