ctrlChecked: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|= Game name" to "|Game name=")
m (Text replacement - "\{\{Feature *\| *Informative *\| ([^↵]+) *\}\}" to "{{Feature|informative|$1}}")
 
(46 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|version1= 0.50


|0.50|= Game version
|gr1= GUI Control
____________________________________________________________________________________________


| Returns the current state of given checkbox in checkboxes control (CT_CHECKBOXES type 7 of [[Dialog Control]]). Since Arma 3 v1.71.141591 it is possible to query multiple checkboxes by providing checkbox index. For more information see [[DialogControls-CheckBoxes]]. <br><br>
|descr= Returns the current state of given [[CT_CHECKBOXES]] control. Since Arma 3 v1.72 it is possible to query multiple checkboxes by providing checkbox index. For more information see [[CT_CHECKBOXES]].{{Feature|informative|The {{hl|"CheckBoxesSelChanged"}} control EH returns the control, index of changed checkbox and its current checked state. The checked state however is not a [[Boolean]] but [[Number]] 0 or 1. To convert [[ctrlChecked]] command output into number as well, use [[parseNumber]] command}}
{{Informative | The <tt>"CheckBoxesSelChanged"</tt> control EH returns the control, index of changed checkbox and its current checked state. The checked state however is not a [[Boolean]] but [[Number]] 0 or 1. To convert [[ctrlChecked]] command output into number as well, use [[parseNumber]] command}}|DESCRIPTION=
____________________________________________________________________________________________


| '''ctrlChecked''' control |SYNTAX=
|s1= [[ctrlChecked]] control


|p1= control: [[Control]] - CT_CHECKBOXES control. If control contain multiple checkboxes, only checkbox with index 0 is queried.|PARAMETER1= 
|p1= control: [[Control]] - [[CT_CHECKBOXES]] control. If control contain multiple checkboxes, only checkbox with index 0 is queried.


| [[Boolean]] - [[true]] checked, [[false]] unchecked |RETURNVALUE=
|r1= [[Boolean]] - [[true]] checked, [[false]] unchecked


|s2= control [[ctrlChecked]]  index


|s2= control '''ctrlChecked''' index &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(''Since Arma 3 v1.71.141591'') |SYNTAX=
|s2since= arma3 1.72


|p21= control: [[Control]] - CT_CHECKBOXES control |PARAMETER1= 
|p21= control: [[Control]] - [[CT_CHECKBOXES]] control
|p22= index: [[Number]] - checkbox index |PARAMETER1= 
|p22= index: [[Number]] - checkbox index


| r2= [[Boolean]] - [[true]] checked, [[false]] unchecked|RETURNVALUE=
|r2= [[Boolean]] - [[true]] checked, [[false]] unchecked


|x1= <code>[[ctrlChecked]] _control;</code>|EXAMPLE1=
|x1= <sqf>ctrlChecked _control;</sqf>
|x2= <code>_control [[ctrlChecked]] 3;</code>|EXAMPLE1=
____________________________________________________________________________________________


| [[ctrlSetChecked]], [[cbChecked]], [[cbSetChecked]] |SEEALSO=  
|x2= <sqf>_control ctrlChecked 3;</sqf>


| |MPBEHAVIOUR=  
|seealso= [[ctrlSetChecked]] [[cbChecked]] [[cbSetChecked]]
____________________________________________________________________________________________
}}
}}
<h3 style='display:none'>Notes</h3>
<dl class='command_description'>
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style='display:none'>Bottom Section</h3>
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Arma 3: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]]

Latest revision as of 18:11, 15 March 2024

Hover & click on the images for description

Description

Description:
Returns the current state of given CT_CHECKBOXES control. Since Arma 3 v1.72 it is possible to query multiple checkboxes by providing checkbox index. For more information see CT_CHECKBOXES.
The "CheckBoxesSelChanged" control EH returns the control, index of changed checkbox and its current checked state. The checked state however is not a Boolean but Number 0 or 1. To convert ctrlChecked command output into number as well, use parseNumber command
Groups:
GUI Control

Syntax

Syntax:
ctrlChecked control
Parameters:
control: Control - CT_CHECKBOXES control. If control contain multiple checkboxes, only checkbox with index 0 is queried.
Return Value:
Boolean - true checked, false unchecked

Alternative Syntax

Syntax:
control ctrlChecked index
Parameters:
control: Control - CT_CHECKBOXES control
index: Number - checkbox index
Return Value:
Boolean - true checked, false unchecked

Examples

Example 1:
ctrlChecked _control;
Example 2:
_control ctrlChecked 3;

Additional Information

See also:
ctrlSetChecked cbChecked cbSetChecked

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note