tgui_input_text ![code/modules/tgui_input/text.dm 56](git.png)
tgui_input_text
Datum used for instantiating and using a TGUI-controlled text input that prompts the user with a message and has an input for text entry.
Vars | |
closed | Boolean field describing if the tgui_input_text was closed by the user. |
---|---|
default | The default (or current) value, shown as a default. |
encode | Whether the input should be stripped using html_encode |
entry | The entry that the user has return_typed in. |
max_length | The maximum length for text entry |
message | The prompt's body, if any, of the TGUI window. |
multiline | Multiline input for larger input boxes. |
start_time | The time at which the text input was created, for displaying timeout progress. |
state | The TGUI UI state that will be returned in ui_state(). Default: always_state |
timeout | The lifespan of the text input, after which the window will close and delete itself. |
title | The title of the TGUI window |
Procs | |
set_entry | Sets the return value for the tgui text proc. If html encoding is enabled, the text will be encoded. This can sometimes result in a string that is longer than the max length. If the string is longer than the max length, it will be clipped. |
wait | Waits for a user's response to the tgui_input_text's prompt before returning. Returns early if the window was closed by the user. |
Var Details
closed ![code/modules/tgui_input/text.dm 58](git.png)
Boolean field describing if the tgui_input_text was closed by the user.
default ![code/modules/tgui_input/text.dm 60](git.png)
The default (or current) value, shown as a default.
encode ![code/modules/tgui_input/text.dm 62](git.png)
Whether the input should be stripped using html_encode
entry ![code/modules/tgui_input/text.dm 64](git.png)
The entry that the user has return_typed in.
max_length ![code/modules/tgui_input/text.dm 66](git.png)
The maximum length for text entry
message ![code/modules/tgui_input/text.dm 68](git.png)
The prompt's body, if any, of the TGUI window.
multiline ![code/modules/tgui_input/text.dm 70](git.png)
Multiline input for larger input boxes.
start_time ![code/modules/tgui_input/text.dm 72](git.png)
The time at which the text input was created, for displaying timeout progress.
state ![code/modules/tgui_input/text.dm 80](git.png)
The TGUI UI state that will be returned in ui_state(). Default: always_state
timeout ![code/modules/tgui_input/text.dm 74](git.png)
The lifespan of the text input, after which the window will close and delete itself.
title ![code/modules/tgui_input/text.dm 76](git.png)
The title of the TGUI window
Proc Details
set_entry
Sets the return value for the tgui text proc. If html encoding is enabled, the text will be encoded. This can sometimes result in a string that is longer than the max length. If the string is longer than the max length, it will be clipped.
wait
Waits for a user's response to the tgui_input_text's prompt before returning. Returns early if the window was closed by the user.