CONTROL SET CHECK statement

Purpose

Set the Check State for a CHECK3STATE or CHECKBOX control.

Syntax

CONTROL SET CHECK hDlg, id&, checkstate&

Remarks

With a checkbox control, the Check State is set (checked) when an 'X' symbol is shown in the check box. The Check State is deemed unset (unchecked or cleared) when the check box is empty.

A CHECK3STATE control supports a third state, known as indeterminate. In this state, the check box is grayed.

hDlg refers to the dialog that owns the control.

id& is the unique control identifier as assigned to the button control with a CONTROL ADD statement.

For CHECKBOX controls, set checkstate& to zero (0) to uncheck (unset or clear) the Check State of the control, or one (1) to check (set) the Check State of the control.

For CHECK3STATE controls, set checkstate& to zero (0) to uncheck (unset or clear) the Check State of the control, one (1) to check (set) the Check State (display an 'X' symbol in the box), or two (2) to set the indeterminate state (display a grayed check box).

To set the Check State of OPTION controls, use the CONTROL SET OPTION statement.