Description
Settings for a column whose edit style is CheckBox.
Applies to
Column controls
Syntax
PowerBuilder dot notation:
dw_control.Object.columnname.CheckBox.property
Describe and Modify argument:
"columnname.CheckBox.property { = value }"
|
Parameter |
Description |
|---|---|
|
columnname |
The column whose edit style is CheckBox for which you want to get or set property values. |
|
property |
A property for the CheckBox edit style, as listed in the table below. |
|
value |
Values for the properties are shown in the table below. For CheckBox properties, value cannot be a DataWindow expression. |
|
Property for CheckBox |
Value |
|---|---|
|
LeftText |
Whether the CheckBox label is to the left or right of the CheckBox. Values are: Yes -- Display the label on the left. No -- Display the label on the right. Painter: Edit tab, Left Text option. |
|
Off |
A string constant specifying the column value when the CheckBox is off (unchecked). The resulting value must be the same datatype as the column. Painter: Edit tab, Data Value for Off option. |
|
On |
A string constant specifying the value that will be put in the column when the CheckBox is on (checked). The resulting value must be the same datatype as the column. Painter: Edit tab, Data Value for On option. |
|
Other |
A string constant specifying the value that will be put in the column when the CheckBox is in the third state (neither checked nor unchecked). The value must be the same datatype as the column. Painter: Edit tab, This option is available when ThreeStates is True. |
|
Scale |
Whether you want to scale the 2D CheckBox. Takes effect only when the ThreeD property is No. Values are: Yes -- Scale the CheckBox. No -- Do not scale the CheckBox. Painter: Edit tab,Scale option. |
|
Text |
A string specifying the CheckBox's label text. Painter: Edit tab, Text option. |
|
ThreeD |
Whether the CheckBox should be 3D. Values are: Yes -- Make the CheckBox 3D No -- Do not make the CheckBox 3D Painter: Edit tab, 3D Look option. |
|
ThreeStates |
Whether the CheckBox should have three states. Values are: Yes -- The CheckBox has three states No -- The CheckBox does not have three states Painter: Edit tab, 3 States option. |
Usage
In the painter
Select the control and set values in the Properties view, Edit tab, when Style Type option is CheckBox.
Examples
dw1.Modify("emp_gender.CheckBox.3D=no")
IF dw1.Describe("emp_status.CheckBox.LeftText") &
= "yes" THEN
dw1.Modify("emp_status2.CheckBox.LeftText=yes")
END IF
dw1.Modify("emp_status.CheckBox.Off='Terminated'")
dw1.Modify("emp_status.CheckBox.On='Active'")
dw1.Modify("emp_status.CheckBox.Other='Unknown'")
dw1.Object.emp_gender.CheckBox.ThreeD = "no"
IF dw1.Object.emp_status.CheckBox.LeftText = "yes" THEN
dw1.Object.emp_status2.CheckBox.LeftText = "yes"
END IF