ctrlSetText: Difference between revisions

Latest revision as of 17:15, 26 April 2026

1.75

1.00

Hover & click on the images for description

Description

Description:

Sets the text of a control of the currently active user dialog or display. This command can be used for static texts, buttons, edit lines and active texts as well as for images, where you can use it to set the image path.
Read Arma: GUI Configuration for more information about user dialogs and controls.
Use endl to insert line breaks. Since

2.06 supported control types are:

Since

2.22 CT_PROGRESS is also supported.

Groups:

GUI Control

Syntax

Syntax:: ctrlSetText [idc, text]
Parameters:: idc: Number - control IDC
: text: String - text or image path or texture, depending on the control type
Return Value:: Nothing

Alternative Syntax

Syntax:: control ctrlSetText text
Parameters:: control: Control - control
: text: String - text or image path or texture, depending on the control type
Return Value:: Nothing

Examples

Example 1:: ctrlSetText [100, "Hello world"]; // for Dialogs
Example 2:: _control ctrlSetText "Hello world."; // for Displays
Example 3:: Since Arma 3 2.22:
with uiNamespace do { bar = findDisplay 46 ctrlCreate ["RscProgress", -1]; bar ctrlSetText "\A3\Data_F\Flags\Flag_red_CO.paa"; bar ctrlSetPosition [0,0,1,0.25]; bar ctrlCommit 0; bar progressSetPosition 0.7; };

Additional Information

See also:: ctrlText ctrlTextSelection ctrlSetTextSelection

Notes

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

@@ Line 2: / Line 2: @@
 |game1= ofp
 |version1= 1.75
 |game2= ofpe
 |version2= 1.00
 |game3= arma1
 |version3= 1.00
 |game4= arma2
 |version4= 1.00
 |game5= arma2oa
+|version5= 1.50
-|version5= 1.51
 |game6= tkoh
 |version6= 1.00
 |game7= arma3
 |version7= 0.50
@@ Line 35: / Line 28: @@
 |gr1= GUI Control
-|descr= Sets the text of a control of the currently active user dialog or display. This command can be used for: static texts, buttons, edit lines and active texts as well as for images, where you can use it to set the image path. Read [[Arma: GUI Configuration]] for more information about user dialogs and controls.
+|descr= Sets the text of a control of the currently active user dialog or display.
-{{Feature|Warning|<tt>[[ctrlSetText]] [idc, text]</tt> syntax does not support [[CT_SHORTCUTBUTTON]], but the alternative syntax <tt>control [[ctrlSetText]] text</tt> does.}}
+This command can be used for static texts, buttons, edit lines and active texts as well as for images, where you can use it to set the image path.
+<br>
+Read [[Arma: GUI Configuration]] for more information about user dialogs and controls.<br>
+Use [[endl]] to insert line breaks.
+Since {{GVI|arma3|2.06|size= 0.75}} supported control types are:
+{{Columns|4|
+* [[CT_STATIC]]
+* [[CT_EDIT]]
+* [[CT_XKEYDESC]]
+* [[CT_XBUTTON]]
+* [[CT_SHORTCUTBUTTON]]
+* [[CT_STRUCTURED_TEXT]]
+* [[CT_BUTTON]]
+* [[CT_ACTIVETEXT]]
+}}
+Since {{GVI|arma3|2.22|size= 0.75}} [[CT_PROGRESS]] is also supported.
 |s1= [[ctrlSetText]] [idc, text]
-|p1= idc: [[Number]] - Control IDC
+|p1= idc: [[Number]] - control IDC
-|p2= text: [[String]] - Text or image path, depending on the control type
+|p2= text: [[String]] - text or image path or texture, depending on the control type
 |r1= [[Nothing]]
@@ Line 48: / Line 58: @@
 |s2= control [[ctrlSetText]] text
-|p21=  control: [[Control]]
+|p21= control: [[Control]] - control
-|p22= text: [[String]]
+|p22= text: [[String]] - text or image path or texture, depending on the control type
 |r2= [[Nothing]]
-|x1= <code>[[ctrlSetText]] [100, "Hello world"]; {{cc|for Dialogs}}</code>
-|x2= <code>_control [[ctrlSetText]] "Hello world."; {{cc|for Displays}}</code>
+|x1= <sqf>ctrlSetText [100, "Hello world"]; // for Dialogs</sqf>
+|x2= <sqf>_control ctrlSetText "Hello world."; // for Displays</sqf>
+|x3= Since Arma 3 2.22:
+<sqf>with uiNamespace do
+{
+ bar = findDisplay 46 ctrlCreate ["RscProgress", -1];
+ bar ctrlSetText "\A3\Data_F\Flags\Flag_red_CO.paa";
+ bar ctrlSetPosition [0,0,1,0.25];
+ bar ctrlCommit 0;
+ bar progressSetPosition 0.7;
+};
+</sqf>
 |seealso= [[ctrlText]] [[ctrlTextSelection]] [[ctrlSetTextSelection]]
 }}