ctrlSetText: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|r2= Nothing |RETURNVALUE= " to "|r2= Nothing |RETURNVALUE2= ")
(moved note into description)
Line 13: Line 13:
| 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.
| 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.


Read [[Dialog Control]] for more information about user dialogs and controls. |DESCRIPTION=
Read [[Dialog Control]] for more information about user dialogs and controls.
 
<br><br>{{Warning | <tt>[[ctrlSetText]] [idc, text]</tt> syntax does not support [[CT_SHORTCUTBUTTON]], but the alternative syntax <tt>controlName [[ctrlSetText]] text</tt> does. }} |DESCRIPTION=
____________________________________________________________________________________________
____________________________________________________________________________________________


Line 36: Line 38:
____________________________________________________________________________________________
____________________________________________________________________________________________
   
   
|x1= <pre>ctrlSetText [100, "Hello world"];//for Dialogs</pre> |EXAMPLE1=
|x1= <code>[[ctrlSetText]] [100, "Hello world"]; // for Dialogs</code> |EXAMPLE1=


|x2= <pre>_control ctrlSetText "Hello world.";// for Displays</pre> |EXAMPLE2=
|x2= <code>_control [[ctrlSetText]] "Hello world."; // for Displays</code> |EXAMPLE2=
____________________________________________________________________________________________
____________________________________________________________________________________________


Line 48: Line 50:
<dl class="command_description">
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- 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 -->
<!-- Note Section END -->
</dl>
</dl>
Line 66: Line 63:
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
<!-- CONTINUE Notes -->
<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 -->

Revision as of 19:47, 24 September 2019

Hover & click on the images for description

Description

Description:
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. Read Dialog Control for more information about user dialogs and controls.

ctrlSetText [idc, text] syntax does not support CT_SHORTCUTBUTTON, but the alternative syntax controlName ctrlSetText text does.
Groups:
Uncategorised

Syntax

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

Alternative Syntax

Syntax:
controlName ctrlSetText text
Parameters:
controlName: 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

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

Notes

Bottom Section