Control CheckBox clause - MapBasic - 2023

Purpose

Part of a Dialog statement; adds a check box control to a dialog box

Syntax

Control CheckBox 
	[ Position x, y ] [ Width w ] 
	[ ID control_ID ] 
	[ Calling handler ] 
	[ Title title_string ] 
	[ Value log_value ] 
	[ Into log_variable ] 
	[ Disable ] [ Hide ]

x, y specifies the control's position in dialog box units.

w specifies the width of the control in dialog box units.

control_ID is an integer; cannot be the same as the ID of another control in the dialog box.

handler is the name of a procedure to call if the user clicks on the control.

title_string is a text string to appear in the label to the right of the check-box.

log_value is a logical value: FALSE sets the control to appear un-checked initially.

log_variable is the name of a logical variable.

Description

If a Dialog statement includes a Control CheckBox clause, the dialog box includes a check box control.

The Value clause controls the initial appearance. If the Value clause is omitted, or if it specifies a value of TRUE, the check box is checked initially. If the Value clause specifies a FALSE value, check-box is clear initially. Disable makes the control disabled (grayed out) initially. Hide makes the control hidden initially.

Example

Control CheckBox 
	Title "Include &Legend" 
	Into showlegend 
	ID 6 
	Position 115, 155

See Also:

Alter Control statement, Dialog statement, ReadControlValue() function