ctrlActivate: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
No edit summary
Line 18: Line 18:
|gr1= GUI Control
|gr1= GUI Control


|descr= Launches action attached to given (button based) control. Main syntax command only triggers engine-based actions (cancel or ok codes) and will not trigger button related [[User_Interface_Event_Handlers|User Interface Event Handlers]] or [[buttonAction]], use the alternative syntax for this.<br>
|descr= Launches action attached to given (button based) control. Main syntax command only triggers engine-based actions (cancel or ok codes) and will not trigger button related [[User_Interface_Event_Handlers|User Interface Event Handlers]] or [[buttonAction]], use the alternative syntax for this. "ButtonClick" UI event handler will also be triggered with the alternative syntax.<br>
Command ignores control disabled state. (Example 2)
Command ignores control disabled state. (Example 2)


Line 29: Line 29:
|s2= control [[ctrlActivate]] full
|s2= control [[ctrlActivate]] full
|s2since= arma3 2.16
|s2since= arma3 2.16
|p21= control: [[Control]] - button based control
|p21= control: [[Control]] - button based control ([[CT_BUTTON]], [[CT_XBUTTON]], [[CT_SHORTCUTBUTTON]], [[CT_ACTIVETEXT]])
|p22= full: [[Boolean]] - [[true]] to simulate button click in full including "ButtonClick" event handling
|p22= full: [[Boolean]] - [[true]] to simulate button click in full including "ButtonClick" event handling
|r2= [[Nothing]]
|r2= [[Nothing]]

Revision as of 16:15, 6 November 2023

Hover & click on the images for description

Description

Description:
Launches action attached to given (button based) control. Main syntax command only triggers engine-based actions (cancel or ok codes) and will not trigger button related User Interface Event Handlers or buttonAction, use the alternative syntax for this. "ButtonClick" UI event handler will also be triggered with the alternative syntax.
Command ignores control disabled state. (Example 2)
Groups:
GUI Control

Syntax

Syntax:
ctrlActivate control
Parameters:
control: Control
Return Value:
Nothing

Alternative Syntax

Syntax:
control ctrlActivate full
Parameters:
control: Control - button based control (CT_BUTTON, CT_XBUTTON, CT_SHORTCUTBUTTON, CT_ACTIVETEXT)
full: Boolean - true to simulate button click in full including "ButtonClick" event handling
Return Value:
Nothing

Examples

Example 1:
ctrlActivate _control;
Example 2:
_control ctrlEnable false; ctrlActivate _control; // Action fired.

Additional Information

See also:
allControls allDisplays controlsGroupCtrl ctrlDelete ctrlModel ctrlSetModel ctrlPosition ctrlSetPosition ctrlClassName ctrlModelScale ctrlSetModelScale ctrlModelDirAndUp ctrlSetModelDirAndUp displayParent

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