Differences

This shows you the differences between two versions of the page.

--- 4rpl:commands:setunituitext [2021/01/24 19:48] – added get/set tabs Sanian
+++ 4rpl:commands:setunituitext [2025/02/14 14:57] (current) – external edit 127.0.0.1
@@ Line 11: / Line 11: @@
 ===== Description =====
-Sets the string UI text for a given UI control slot.  Custom units can have UI configuration widgets. These are configured in the CPack manager.
+Sets the string UI text for a given UI control slot.  Custom units can have UI configuration widgets. These are configured in the CPack manager.\\
-Each widget occupies a slot, 0-7. Each widget also has a text.
+Each widget occupies a slot, 0-7. Each widget also has a text.\\
 For the Label and Button widgets the text is what is shown on the widget.\\
 For the Flip and Choice widget, the text is the label and the value is controlled by the state.\\
+To change the text for the options in a choice widget, see [[4rpl:commands:setunituioptions|SetUnitUIOptions]].\\
 \\
 Note that this call only works on custom units.  If used on a built in unit, it will do nothing.\\
+:NOTE:\\
+Many formats are supported in the UI text such as <nowiki><color></nowiki> though they will only work if closed.\\
+Line break formats are one of the few which will fail. To create a line break, add a line break via pressing ENTER to create a new line (see 2nd example) or concat [[4rpl:commands:lf|LF]] (3rd example).\\
+<br>, \n, and [[4rpl:commands:cr|CR]] will fail to create a line break.\\
 ===== Examples =====
 <code 4rpl>
-   SetUnitUIText(self 0 "Sample Text")
+SetUnitUIText(self 0 "<color=#FFFF00>Sample Colored Text</color>")
 </code>
+<code 4rpl>
+SetUnitUIText(self 0 "Sample Text
+New line text
+Third line text")
+</code>
+<code 4rpl>
+SetUnitUIText(self 0 Concat3("Sample Text" LF "New line text"))
+</code>
 <=[[4rpl:start| Index]]

Knuckle Cracker Wiki

User Tools

Site Tools

Differences

Page Tools