Purpose

To define a radio button or check box.

Syntax

winio@('%rb[button_text]', ctrl)
winio@('%~rb[button_text]', ctrl, grey_ctrl)
integer ctrl     (input/output)
integer grey_ctrl     (input)

Modifiers

Grave accent (`) - provides a check box rather than a radio button.

Caret (^) - call-back is called when the control is selected.

Question mark (?) - a help string is supplied.

Tilde (~) - adds a variable that controls the grey (enable/disable) state.

Description

button_text is a standard character string (can be replaced by @) for the text attached to the radio button. To change the text dynamically use %lc - Handle of Last Control and the API function SetWindowText.

ctrl is 1 (on) or 0 (off).

grey_ctrl is 1 (enabled) or 0 (disable/greyed). A call-back function (if present) is placed after this control variable.

%rb can be used in conjunction with the gang format code %ga - Gang Controls. Note that it is not conventional to gang check boxes.

Example

winio@('%rb[Button 1]', rb1)

See also

%ga - Gang Controls