User Tools

Site Tools


4rpl:commands:setunituitext

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
4rpl:commands:setunituitext [2022/10/25 12:41] – Formatting note and line breaking method provided Vertu4rpl:commands:setunituitext [2025/02/14 14:57] (current) – external edit 127.0.0.1
Line 11: Line 11:
  
 ===== Description ===== ===== 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 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.\\ 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 that this call only works on custom units.  If used on a built in unit, it will do nothing.\\
  
 :NOTE:\\ :NOTE:\\
-All formats do not operate in the UI text such as <color> and <b>.\\ +Many formats are supported in the UI text such as <nowiki><color></nowikithough they will only work if closed.\\ 
-To create a line break, add a line break via pressing ENTER to create a new line (see 2nd example). <br> and [[4rpl:commands:cr|CR]] will fail to create a line break.+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 ===== ===== Examples =====
 <code 4rpl> <code 4rpl>
-SetUnitUIText(self 0 "Sample Text")+SetUnitUIText(self 0 "<color=#FFFF00>Sample Colored Text</color>")
 </code> </code>
 <code 4rpl> <code 4rpl>
Line 29: Line 31:
 New line text New line text
 Third line text") Third line text")
 +</code>
 +<code 4rpl>
 +SetUnitUIText(self 0 Concat3("Sample Text" LF "New line text"))
 </code> </code>
  
 <=[[4rpl:start| Index]] <=[[4rpl:start| Index]]
  
4rpl/commands/setunituitext.1666701694.txt.gz · Last modified: 2025/02/14 14:56 (external edit)