UI (functions)/Textbox: Difference between revisions
Created page with "== WaitShowDialogue == Displays a dialogue box with text, waiting until the player completes it. Takes a string as an argument. === Arguments === Argument order is <code>UI:WaitShowDialouge(text, callbacks)</code> {| class="wikitable" |- ! Name !! Type !! Technical Type !! Purpose !! Required |- | text || String || ? || The text to display with the textbox. || Yes |- | callbacks || Lua Table || ? || A table of callbacks to be called by the textbox for customization fe..." |
|||
| (2 intermediate revisions by the same user not shown) | |||
| Line 138: | Line 138: | ||
== TextPopUp == | == TextPopUp == | ||
Makes text pop up in the bottom-left corner by default. Displays concurrently with any other process. | Makes text pop up in the bottom-left corner by default. Displays concurrently with any other process. | ||
=== Arguments === | === Arguments === | ||
| Line 180: | Line 178: | ||
| time || Integer || System.Int32 || How long the text takes to fade in. || No | | time || Integer || System.Int32 || How long the text takes to fade in. || No | ||
|} | |} | ||
=== Example === | === Example === | ||
| Line 191: | Line 186: | ||
</pre> | </pre> | ||
== | == TextShowTitle == | ||
Shows text in the format of a title drop. Requires WaitDialog to actually display. | Shows text in the format of a title drop. Requires WaitDialog to actually display. | ||
=== Arguments === | |||
{| class="wikitable" | |||
{{ArgHeader}} | |||
{{ArgRow | |||
|name=text | |||
|type=String | |||
|techt=System.String | |||
|purp=The text to display. | |||
}} | |||
{{ArgRow | |||
|name=time | |||
|type=Integer | |||
|techt=System.Int32 | |||
|purp=The time for the text to fade in. | |||
}} | |||
|} | |||
== WaitHideTitle == | |||
Fades out the currently displayed title, waiting until the fade-out is complete. | |||
=== Arguments === | === Arguments === | ||
{| class="wikitable" | |||
{{ArgHeader}} | |||
{{ArgRow | |||
|name=time | |||
|type=Integer | |||
|techt=System.Int32 | |||
|purp=The time for the text to fade in. | |||
}} | |||
|} | |||
=== Example === | |||
<pre> | |||
UI:WaitHideTitle(60) | |||
</pre> | |||
== TextFadeTitle == | |||
Fades out the text set in a title drop. Requires WaitDialog to actually fade. | |||
=== Arguments === | === Arguments === | ||
{| class="wikitable" | |||
{{ArgHeader}} | |||
{{ArgRow | |||
|name=time | |||
|type=Integer | |||
|techt=System.Int32 | |||
|purp=The time for the text to fade in. | |||
}} | |||
|} | |||
== WaitDialog == | |||
Displays the currently set dialogue box and waits for the player to complete it. | |||
=== Example === | === Example === | ||
| Line 214: | Line 252: | ||
<pre> | <pre> | ||
UI: | UI:WaitDialog() | ||
</pre> | </pre> | ||
== | == _DummyWait == | ||
Instantly break. Used as default/invalid value when returning a yieldable value. | |||
Latest revision as of 04:51, 18 January 2026
WaitShowDialogue
Displays a dialogue box with text, waiting until the player completes it. Takes a string as an argument.
Arguments
Argument order is UI:WaitShowDialouge(text, callbacks)
| Name | Type | Technical Type | Purpose | Required |
|---|---|---|---|---|
| text | String | ? | The text to display with the textbox. | Yes |
| callbacks | Lua Table | ? | A table of callbacks to be called by the textbox for customization features. | No |
Example
UI:WaitShowDialogue("Hello World!")
WaitShowTimedDialogue
Displays a dialogue box with text, waiting until the specified time has expired.
Arguments
Argument order is UI:WaitShowTimedDialouge(text, waitTime, callbacks)
| Name | Type | Technical Type | Purpose | Required |
|---|---|---|---|---|
| text | String | ? | The text to display with the textbox. | Yes |
| waitTime | Integer | ? | The time for the textbox to remain on screen. Pass -1 to wait for layer input. | Yes |
| callbacks | Lua Table | ? | A table of callbacks to be called by the textbox for customization features. | No |
Example
UI:WaitShowTimedDialogue("Hello World!", 120)
TextDialogue
Sets the current dialogue text to be shown. Requires WaitDialog to actually display.
Arguments
Argument order is UI:TextDialogue(text, waitTime, callbacks)
| Name | Type | Technical Type | Purpose | Required |
|---|---|---|---|---|
| text | String | System.String | The text to display with the textbox. | Yes |
| waitTime | Integer | System.Int32 | The time for the textbox to remain on screen. Pass -1 to wait for layer input. | No |
| callbacks | Lua Table | NLua.LuaTable | A table of callbacks to be called by the textbox for customization features. | No |
WaitShowVoiceOver
Displays a voice over, waiting until the player completes it.
Arguments
Argument order is UI:WaitShowVoiceOver(text, expireTime, x, y, width, height, callbacks)
| Name | Type | Technical Type | Purpose | Required |
|---|---|---|---|---|
| text | String | System.String | The text to display with the textbox. | Yes |
| expireTime | Integer | System.Int32 | The time for the textbox to remain on screen. Pass -1 to wait for layer input. | No |
| x | Integer | System.Int32 | The starting X position of the box. | No |
| y | Integer | System.Int32 | The starting Y position of the box | No |
| width | Integer | System.Int32 | The width of the box. | No |
| height | Integer | System.Int32 | The height of the box. | No |
| callbacks | Lua Table | NLua.LuaTable | A table of callbacks to be called by the textbox for customization features. | No |
Example
UI:WaitShowVoiceOver("Hello World!", 120)
TextVoiceOver
Sets the current voice-over text to be shown. Requires WaitDialog to actually display.
Arguments
Argument order is UI:TextVoiceOver(text, expireTime, x, y, width, height, callbacks)
| Name | Type | Technical Type | Purpose | Required |
|---|---|---|---|---|
| text | String | System.String | The text to display with the textbox. | Yes |
| expireTime | Integer | System.Int32 | The time for the textbox to remain on screen. Pass -1 to wait for layer input. | No |
| x | Integer | System.Int32 | The starting X position of the box. | No |
| y | Integer | System.Int32 | The starting Y position of the box | No |
| width | Integer | System.Int32 | The width of the box. | No |
| height | Integer | System.Int32 | The height of the box. | No |
| callbacks | Lua Table | NLua.LuaTable | A table of callbacks to be called by the textbox for customization features. | No |
TextPopUp
Makes text pop up in the bottom-left corner by default. Displays concurrently with any other process.
Arguments
Argument order is UI:TextPopUp(text, expireTime, x, y, width, height, callbacks)
| Name | Type | Technical Type | Purpose | Required |
|---|---|---|---|---|
| text | String | System.String | The text to display with the textbox. | Yes |
| expireTime | Integer | System.Int32 | The time for the textbox to remain on screen. Pass -1 to wait for layer input. | No |
| x | Integer | System.Int32 | The starting X position of the box. | No |
| y | Integer | System.Int32 | The starting Y position of the box | No |
| width | Integer | System.Int32 | The width of the box. | No |
| height | Integer | System.Int32 | The height of the box. | No |
| centerH | Boolean | System.Boolean | True if the text should be centered horizontally. | No |
| centerV | Boolean | System.Boolean | True if the text should be centered vertically. | No |
WaitShowTitle
Fades in a title text, waiting until the fade-in is complete.
Arguments
Argument order is UI:WaitShowTitle(text, time)
| Name | Type | Technical Type | Purpose | Required |
|---|---|---|---|---|
| text | String | System.String | The text to display with the textbox. | Yes |
| time | Integer | System.Int32 | How long the text takes to fade in. | No |
Example
UI:WaitShowTitle("Hello World!", 60)
TextShowTitle
Shows text in the format of a title drop. Requires WaitDialog to actually display.
Arguments
| Name | Type | Technical Type | Purpose |
|---|---|---|---|
| text | String | System.String
|
The text to display. |
| time | Integer | System.Int32
|
The time for the text to fade in. |
WaitHideTitle
Fades out the currently displayed title, waiting until the fade-out is complete.
Arguments
| Name | Type | Technical Type | Purpose |
|---|---|---|---|
| time | Integer | System.Int32
|
The time for the text to fade in. |
Example
UI:WaitHideTitle(60)
TextFadeTitle
Fades out the text set in a title drop. Requires WaitDialog to actually fade.
Arguments
| Name | Type | Technical Type | Purpose |
|---|---|---|---|
| time | Integer | System.Int32
|
The time for the text to fade in. |
WaitDialog
Displays the currently set dialogue box and waits for the player to complete it.
Example
UI:WaitDialog()
_DummyWait
Instantly break. Used as default/invalid value when returning a yieldable value.
