Lua:Class:CheckBox

CheckBox Class (Inheritance ButtonControl->WinControl->Control->Component->Object) The Checkbox is a visual component that lets the user click it and change state between checked, unchecked, and if possible, grayed

createCheckBox(owner) Creates a CheckBox class object which belongs to the given owner. Owner can be any object inherited from WinControl

checkbox_getAllowGrayed(CheckBox) Gets the AllowGrayed property

checkbox_setAllowGrayed(CheckBox, boolean) Sets the AllowGrayed property

checkbox_getState(checkbox) Gets the current state of the checkbox

 0=Unchecked
 1=Checked
 2=Grayed

checkbox_setState(checkbox, state) Sets the state of the checkbox

 0=Unchecked
 1=Checked
 2=Grayed

checkbox_onChange(checkbox, function) Sets an OnChange event for the checkbox that gets triggered when the state has been changed (by the user of programatically)

 function (sender)

Example:

local form = createForm( true );

local checkBoxes = {};
checkBoxes[1] = createCheckBox( form );
checkBoxes[2] = createCheckBox( form );
checkBoxes[3] = createCheckBox( form );
checkBoxes[4] = createCheckBox( form );
checkBoxes[5] = createCheckBox( form );

for x = 1, #checkBoxes do
    control_setCaption( checkBoxes[x], "This is checkbox " .. tostring( x ) );
    control_setPosition( checkBoxes[x], 10, x * 20 )
end 
checkbox_setState(checkboxes[1], 0)    -- Sets checkboxes[1] to unchecked state.
checkbox_setState(checkboxes[2], 1)    -- Sets checkboxes[2] to checked state.
checkbox_setState(checkboxes[3], 2)    -- checkboxes[3] is grayed out.

if checkbox_getState(checkboxes[4]) then  -- if checkboxes[4] is checked then the function returns true otherwise false.
   print "true"
else
   print "false"
end
</pre.