CONTROL SET OPTION statement

Purpose | Set the Check State for an OPTION (radio) control, and unset the Check State for other OPTION buttons in a group.
Syntax | CONTROL SET OPTION hDlg, id&, minid&, maxid&

Remarks

The Check State is deemed set (checked) when the check box is selected, and unset (unchecked or clear) if the check box is empty. Only one OPTION control in a group of OPTION controls should ever have its Check State set at any given time. OPTION controls in a group should be assigned unique sequential identifier numbers.

hDlg refers to the dialog that owns the OPTION controls.

id& is the unique control identifier as assigned to the button control with a CONTROL ADD OPTION statement. CONTROL SET OPTION sets the Check State for this control, and unsets the Check State for all of the remaining OPTION controls whose identifiers are included in the range minid& through maxid&, inclusive.

The first OPTION control in a group should have the style %WS_GROUP to mark the beginning of a group of buttons, and the first non-OPTION control after the group should also have this style set. If there are no other controls after the group, add %WS_GROUP to the first control in the dialog. This ensures keyboard navigation with the arrow buttons will operate within the group of OPTION controls.

See also | Dynamic Dialog Tools, CONTROL ADD OPTION, CONTROL GET CHECK

Example

#INCLUDE "DDT.INC"

%OPT1 = 101

%OPT2 = 102

%OPT3 = 103

%OPT4 = 104

%OPT5 = 105

FUNCTION PBMAIN

DIM hDlg AS DWORD

DIALOG NEW 0, "OPTION control test", , ,100, 100, _

%WS_SYSMENU OR %WS_CAPTION TO hDlg

CONTROL ADD OPTION, hDlg, %OPT1, "Option 1", 10, 6, 50, 14, _

%WS_GROUP OR %WS_TABSTOP

CONTROL ADD OPTION, hDlg, %OPT2, "Option 2", 10, 20, 50, 14

CONTROL ADD OPTION, hDlg, %OPT3, "Option 3", 10, 34, 50, 14

CONTROL ADD OPTION, hDlg, %OPT4, "Option 4", 10, 48, 50, 14

CONTROL ADD OPTION, hDlg, %OPT5, "Option 5", 10, 62, 50, 14

CONTROL ADD BUTTON, hDlg, %IDOK, "OK", 25, 80, 50, 14, _

%WS_GROUP OR %WS_TABSTOP

' Set the initial state to OPTION button 3

CONTROL SET OPTION hDlg, %OPT3, %OPT1, %OPT5

DIALOG SHOW MODAL hDlg

END FUNCTION