ctrlSetText: Difference between revisions

Latest revision as of 00:08, 4 April 2024

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:

Groups:

GUI Control

Syntax

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

Alternative Syntax

Syntax:: control ctrlSetText text
Parameters:: control: Control
: text: String
Return Value:: Nothing

Examples

Example 1:: ctrlSetText [100, "Hello world"]; // for Dialogs
Example 2:: _control ctrlSetText "Hello world."; // for Displays

Additional Information

See also:: ctrlText ctrlTextSelection ctrlSetTextSelection

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
-|arg= local |Multiplayer Arguments=
+|game3= arma1
+|version3= 1.00
-|eff= local |Multiplayer Effects=
+|game4= arma2
-____________________________________________________________________________________________
+|version4= 1.00
-| Set 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.
+|game5= arma2oa
+|version5= 1.50
-Read [[Dialog Control]] for more information about user dialogs and controls. |DESCRIPTION=
+|game6= tkoh
-____________________________________________________________________________________________
+|version6= 1.00
-| '''ctrlSetText''' [idc, text] |SYNTAX=
+|game7= arma3
+|version7= 0.50
-|p1= [idc, text]: [[Array]] |PARAMETER1=
+|arg= local
-|p2= idc: [[Integer]] - control ID |PARAMETER2=
+|eff= local
-|p3= text: [[String]] - text or image path, depending on the control type |PARAMETER3=
+|gr1= GUI Control
-| [[Nothing]] |RETURNVALUE=
+|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.
+<br>
+Read [[Arma: GUI Configuration]] for more information about user dialogs and controls.<br>
+Use [[endl]] to insert line breaks.
-|s2= controlName '''ctrlSetText''' text |= Alternative Syntax
+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]]
+}}
-|p21=  controlName: [[Control]] |=
+|s1= [[ctrlSetText]] [idc, text]
-|p22= text: [[String]] |=
+|p1= idc: [[Number]] - control IDC
-|r2= [[Nothing]] |RETURNVALUE=
+|p2= text: [[String]] - text or image path, depending on the control type
-____________________________________________________________________________________________
-|x1= <pre>ctrlSetText [100, "Hello world"];//for Dialogs</pre> |EXAMPLE1=
-|x2= <pre>_control ctrlSetText "Hello world.";// for Displays</pre> |EXAMPLE2=
+|r1= [[Nothing]]
-____________________________________________________________________________________________
-| [[ctrlText]] |SEEALSO=
+|s2= control [[ctrlSetText]] text
-}}
+|p21= control: [[Control]]
-<h3 style="display:none">Notes</h3>
+|p22= text: [[String]]
-<dl class="command_description">
-<!-- Note Section BEGIN -->
-<dd class="notedate">Posted on 16 Nov, 2011
-<dt class="note">[[User:HomerJohnston|HomerJohnston]]
-<dd class="note">
-For ArmA2 textured "shortcut" buttons (type = 16), you must use the '''alternative''' syntax.
-<!-- Note Section END -->
+|r2= [[Nothing]]
-</dl>
-<h3 style="display:none">Bottom Section</h3>
+|x1= <sqf>ctrlSetText [100, "Hello world"]; // for Dialogs</sqf>
-[[Category:Scripting Commands|CTRLSETTEXT]]
+|x2= <sqf>_control ctrlSetText "Hello world."; // for Displays</sqf>
-[[Category:Scripting Commands OFP 1.99|CTRLSETTEXT]]
-[[Category:Scripting Commands OFP 1.96|CTRLSETTEXT]]
-[[Category:Scripting Commands ArmA|CTRLSETTEXT]]
-[[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
-<!-- CONTINUE Notes -->
+|seealso= [[ctrlText]] [[ctrlTextSelection]] [[ctrlSetTextSelection]]
-<dl class="command_description">
+}}
-<dd class="notedate">Posted on October 16, 2016 - 22:32 (UTC)</dd>
-<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
-<dd class="note">When using [[ctrlSetText]] with picture control, the path to the texture is cached, so that if the new texture is from the same file as old one, the precious CPU cycles would not be wasted on reloading it.</dd>
-</dl>
-<!-- DISCONTINUE Notes -->