ctrlSetText: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Take[ _]On[ _]Helicopters(\|.*)?\]\]" to "{{GameCategory|tkoh|Scripting Commands}}")
m (Some wiki formatting)
 
(25 intermediate revisions by 4 users not shown)
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


|gr1= GUI Control |GROUP1=
|game5= arma2oa
____________________________________________________________________________________________
|version5= 1.50


| 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.
|game6= tkoh
|version6= 1.00


Read [[Arma: GUI Configuration]] for more information about user dialogs and controls.
|game7= arma3
{{Warning | <tt>[[ctrlSetText]] [idc, text]</tt> syntax does not support [[CT_SHORTCUTBUTTON]], but the alternative syntax <tt>control [[ctrlSetText]] text</tt> does.}} |DESCRIPTION=
|version7= 0.50
____________________________________________________________________________________________


| [[ctrlSetText]] [idc, text] |SYNTAX=  
|arg= local


|p1= [idc, text]: [[Array]] |PARAMETER1=
|eff= local


|p2= idc: [[Number]] - control ID |PARAMETER2=
|gr1= GUI Control


|p3= text: [[String]] - text or image path, depending on the control type |PARAMETER3=
|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.


| [[Nothing]] |RETURNVALUE=
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]]
}}


|s2= control [[ctrlSetText]] text |Alternative Syntax=
|s1= [[ctrlSetText]] [idc, text]


|p21= control: [[Control]] |PARAMETER21=
|p1= idc: [[Number]] - control IDC


|p22= text: [[String]] |PARAMETER22=
|p2= text: [[String]] - text or image path, depending on the control type


|r2= [[Nothing]] |RETURNVALUE2=
|r1= [[Nothing]]
____________________________________________________________________________________________
 
|x1= <code>[[ctrlSetText]] [100, "Hello world"]; {{cc|for Dialogs}}</code> |EXAMPLE1=


|x2= <code>_control [[ctrlSetText]] "Hello world."; {{cc|for Displays}}</code> |EXAMPLE2=
|s2= control [[ctrlSetText]] text
____________________________________________________________________________________________


| [[ctrlText]] [[ctrlTextSelection]] [[ctrlSetTextSelection]] |SEEALSO=
|p21= control: [[Control]]
}}
 
|p22= text: [[String]]
 
|r2= [[Nothing]]


<h3 style="display:none">Notes</h3>
|x1= <sqf>ctrlSetText [100, "Hello world"]; // for Dialogs</sqf>
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>


<h3 style="display:none">Bottom Section</h3>
|x2= <sqf>_control ctrlSetText "Hello world."; // for Displays</sqf>


[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
|seealso= [[ctrlText]] [[ctrlTextSelection]] [[ctrlSetTextSelection]]
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
}}
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}

Latest revision as of 00:08, 4 April 2024

Logo A0.png1.75ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
LALocalLELocal
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 Arma 3 logo black.png2.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
Retrieved from "https://community.bistudio.com/wiki?title=ctrlSetText&oldid=363531"