ctrlText: Difference between revisions

Latest revision as of 15:50, 8 November 2023

1.75

1.00

1.50

1.00

0.50

Hover & click on the images for description

Description

Description:

Returns the text of a control of the currently active user dialog. This command can be used on static texts, buttons, edit lines and active texts as well as for images, where it returns the image path. Does not work on HTML control and returns empty string "". Since Arma 3 v2.05.147765 supported control types are:

Groups:

GUI Control

Syntax

Syntax:: ctrlText idc
Parameters:: idc: Number - control ID
Return Value:: String - the text or image path is returned, dependent on the control type

Alternative Syntax

Syntax:: ctrlText controlName
Parameters:: controlName: Control
Return Value:: String - the text or image path is returned, dependent on the control type

Examples

Example 1:: _text = ctrlText 100;
Example 2:: _text = ctrlText _control;

Additional Information

See also:: ctrlTextSecondary ctrlSetText Arma: GUI Configuration

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

@@ Line 1: / Line 1: @@
-{{Command|Comments=
+{{RV|type=command
-____________________________________________________________________________________________
-| ofp |Game name=
+|game1= ofp
+|version1= 1.75
-|1.5|Game version=
+|game2= ofpe
+|version2= 1.00
-|gr1= GUI Control |GROUP1=
+|game3= arma1
+|version3= 1.00
+|game4= arma2
+|version4= 1.00
+|game5= arma2oa
+|version5= 1.50
-|gr1= GUI Control |GROUP1=
+|game6= tkoh
-____________________________________________________________________________________________
+|version6= 1.00
-| Returns the text of a control of the currently active user dialog. This command can be used on static texts, buttons, edit lines and active texts as well as for images, where it returns the image path. Does not work on HTML control and returns empty string "". |DESCRIPTION=
+|game7= arma3
-____________________________________________________________________________________________
+|version7= 0.50
-| '''ctrlText''' idc |SYNTAX=
+|gr1= GUI Control
-|p1= idc: [[Number]] - control ID |PARAMETER1=
+|descr= Returns the text of a control of the currently active user dialog. This command can be used on static texts, buttons, edit lines and active texts as well as for images, where it returns the image path. Does not work on HTML control and returns empty string "". Since Arma 3 v2.05.147765 supported control types are:
+* [[CT_STATIC]]
+* [[CT_EDIT]]
+* [[CT_XKEYDESC]]
+* [[CT_XBUTTON]]
+* [[CT_SHORTCUTBUTTON]]
+* [[CT_STRUCTURED_TEXT]]
+* [[CT_BUTTON]]
+* [[CT_ACTIVETEXT]]
-| [[String]] - The text or image path is returned, dependent on the control type. |RETURNVALUE=
+|s1= [[ctrlText]]  idc
-____________________________________________________________________________________________
-|s2= '''ctrlText''' controlName |Alternative Syntax=
+|p1= idc: [[Number]] - control ID
-|p21= controlName: [[Control]] |PARAMETER21=
+|r1= [[String]] - the text or image path is returned, dependent on the control type
-|r2= [[String]] - (as above). |RETURNVALUE2=
+|s2= [[ctrlText]]  controlName
-____________________________________________________________________________________________
-|x1= <code>_text = [[ctrlText]] 100</code> |EXAMPLE1=
-|x2= <code>_text = [[ctrlText]] _control</code> |EXAMPLE2=
+|p21= controlName: [[Control]]
-____________________________________________________________________________________________
-| [[ctrlTextSecondary]], [[ctrlSetText]], [[Arma: GUI Configuration]] |SEEALSO=
+|r2= [[String]] - the text or image path is returned, dependent on the control type
-}}
+|x1= <sqf>_text = ctrlText 100;</sqf>
-<h3 style="display:none">Notes</h3>
+|x2= <sqf>_text = ctrlText _control;</sqf>
-<dl class="command_description">
-<!-- Note Section BEGIN -->
-<!-- Note Section END -->
+|seealso= [[ctrlTextSecondary]] [[ctrlSetText]] [[Arma: GUI Configuration]]
-</dl>
+}}
-<h3 style="display:none">Bottom Section</h3>
-[[Category:Scripting Commands|CTRLTEXT]]
-[[Category:Scripting Commands OFP 1.99|CTRLTEXT]]
-[[Category:Scripting Commands OFP 1.96|CTRLTEXT]]
-[[Category:Scripting Commands Armed Assault|CTRLTEXT]]
-[[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]