CheckBox.property

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

3D or ThreeD

Whether the CheckBox should be 3D. Values are:

  • Yes – Make the CheckBox 3D

  • No – Do not make the CheckBox 3D

Painter: 3D Look option.

NoteSetting the Checkbox 3D property When using dot notation, use the term ThreeD instead of 3D.

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: 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: 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: 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: Other State option is available when 3 States is checked.

Scale

Whether you want to scale the 2D CheckBox. Takes effect only when the 3D property is No. Values are:

  • Yes – Scale the CheckBox.

  • No – Do not scale the CheckBox.

Painter: Scale option.

Text

A string specifying the CheckBox’s label text.

Painter: Text option.

Usage


In the painter

Select the control and set values in the Properties view, Edit tab, when Style Type option is CheckBox.

Examples

Example 1

dw_1.Modify("emp_gender.CheckBox.3D=no")

IF dw_1.Describe("emp_status.CheckBox.LeftText") &

		= "yes" THEN

dw_1.Modify("emp_status2.CheckBox.LeftText=yes")

END IF

dw_1.Modify("emp_status.CheckBox.Off='Terminated'")

dw_1.Modify("emp_status.CheckBox.On='Active'")

dw_1.Modify("emp_status.CheckBox.Other='Unknown'")

Example 2

dw_1.Object.emp_gender.CheckBox.ThreeD = "no"

IF dw_1.Object.emp_status.CheckBox.LeftText = "yes" THEN

dw_1.Object.emp_status2.CheckBox.LeftText = "yes"

END IF