godot/doc/classes/LineEdit.xml

203 lines
8.0 KiB
XML
Raw Normal View History

<?xml version="1.0" encoding="UTF-8" ?>
2019-07-05 09:32:53 +00:00
<class name="LineEdit" inherits="Control" category="Core" version="3.1.2">
<brief_description>
Control that provides single line string editing.
</brief_description>
<description>
LineEdit provides a single line string editor, used for text fields.
</description>
<tutorials>
</tutorials>
<methods>
<method name="append_at_cursor">
<return type="void">
</return>
<argument index="0" name="text" type="String">
</argument>
<description>
2017-10-27 22:00:22 +00:00
Adds [code]text[/code] after the cursor. If the resulting value is longer than [member max_length], nothing happens.
</description>
</method>
<method name="clear">
<return type="void">
</return>
<description>
Erases the [code]LineEdit[/code] text.
</description>
</method>
<method name="deselect">
<return type="void">
</return>
<description>
Clears the current selection.
</description>
</method>
<method name="get_menu" qualifiers="const">
<return type="PopupMenu">
</return>
<description>
Returns the [PopupMenu] of this [code]LineEdit[/code]. By default, this menu is displayed when right-clicking on the [code]LineEdit[/code].
</description>
</method>
<method name="menu_option">
<return type="void">
</return>
<argument index="0" name="option" type="int">
</argument>
<description>
2017-10-27 22:00:22 +00:00
Executes a given action as defined in the MENU_* enum.
</description>
</method>
<method name="select">
<return type="void">
</return>
<argument index="0" name="from" type="int" default="0">
</argument>
<argument index="1" name="to" type="int" default="-1">
</argument>
<description>
Selects characters inside [code]LineEdit[/code] between [code]from[/code] and [code]to[/code]. By default [code]from[/code] is at the beginning and [code]to[/code] at the end.
[codeblock]
2017-10-27 22:00:22 +00:00
text = "Welcome"
select() # Welcome
select(4) # ome
select(2, 5) # lco
[/codeblock]
</description>
</method>
<method name="select_all">
<return type="void">
</return>
<description>
2017-10-27 22:00:22 +00:00
Selects the whole [String].
</description>
</method>
</methods>
<members>
<member name="align" type="int" setter="set_align" getter="get_align" enum="LineEdit.Align">
2017-10-27 22:00:22 +00:00
Text alignment as defined in the ALIGN_* enum.
</member>
<member name="caret_blink" type="bool" setter="cursor_set_blink_enabled" getter="cursor_get_blink_enabled">
If [code]true[/code], the caret (visual cursor) blinks.
</member>
<member name="caret_blink_speed" type="float" setter="cursor_set_blink_speed" getter="cursor_get_blink_speed">
2017-10-27 22:00:22 +00:00
Duration (in seconds) of a caret's blinking cycle.
</member>
2018-01-11 22:38:35 +00:00
<member name="caret_position" type="int" setter="set_cursor_position" getter="get_cursor_position">
The cursor's position inside the [code]LineEdit[/code]. When set, the text may scroll to accommodate it.
2018-01-11 22:38:35 +00:00
</member>
2018-08-20 22:35:30 +00:00
<member name="clear_button_enabled" type="bool" setter="set_clear_button_enabled" getter="is_clear_button_enabled">
If [code]true[/code], the [code]LineEdit[/code] will show a clear button if [code]text[/code] is not empty.
2018-08-20 22:35:30 +00:00
</member>
<member name="context_menu_enabled" type="bool" setter="set_context_menu_enabled" getter="is_context_menu_enabled">
If [code]true[/code], the context menu will appear when right clicked.
</member>
<member name="editable" type="bool" setter="set_editable" getter="is_editable">
If [code]false[/code], existing text cannot be modified and new text cannot be added.
</member>
2017-11-24 08:16:27 +00:00
<member name="expand_to_text_length" type="bool" setter="set_expand_to_text_length" getter="get_expand_to_text_length">
If [code]true[/code], the [code]LineEdit[/code] width will increase to stay longer than the [member text]. It will [b]not[/b] compress if the [member text] is shortened.
</member>
<member name="focus_mode" type="int" setter="set_focus_mode" getter="get_focus_mode" enum="Control.FocusMode">
Defines how the [code]LineEdit[/code] can grab focus (Keyboard and mouse, only keyboard, or none). See [code]enum FocusMode[/code] in [Control] for details.
</member>
<member name="max_length" type="int" setter="set_max_length" getter="get_max_length">
Maximum amount of characters that can be entered inside the [code]LineEdit[/code]. If [code]0[/code], there is no limit.
</member>
<member name="placeholder_alpha" type="float" setter="set_placeholder_alpha" getter="get_placeholder_alpha">
2017-10-27 22:00:22 +00:00
Opacity of the [member placeholder_text]. From [code]0[/code] to [code]1[/code].
</member>
<member name="placeholder_text" type="String" setter="set_placeholder" getter="get_placeholder">
Text shown when the [code]LineEdit[/code] is empty. It is [b]not[/b] the [code]LineEdit[/code]'s default value (see [member text]).
</member>
<member name="secret" type="bool" setter="set_secret" getter="is_secret">
If [code]true[/code], every character is replaced with the secret character (see [member secret_character]).
</member>
2018-05-12 07:38:00 +00:00
<member name="secret_character" type="String" setter="set_secret_character" getter="get_secret_character">
The character to use to mask secret input (defaults to "*"). Only a single character can be used as the secret character.
</member>
<member name="text" type="String" setter="set_text" getter="get_text">
String value of the [code]LineEdit[/code].
</member>
</members>
<signals>
<signal name="text_changed">
<argument index="0" name="new_text" type="String">
</argument>
<description>
2017-10-27 22:00:22 +00:00
Emitted when the text changes.
</description>
</signal>
<signal name="text_entered">
<argument index="0" name="new_text" type="String">
</argument>
<description>
Emitted when the user presses [code]KEY_ENTER[/code] on the [code]LineEdit[/code].
</description>
</signal>
</signals>
<constants>
2017-11-24 22:16:30 +00:00
<constant name="ALIGN_LEFT" value="0" enum="Align">
Aligns the text on the left hand side of the [code]LineEdit[/code].
</constant>
2017-11-24 22:16:30 +00:00
<constant name="ALIGN_CENTER" value="1" enum="Align">
Centers the text in the middle of the [code]LineEdit[/code].
</constant>
2017-11-24 22:16:30 +00:00
<constant name="ALIGN_RIGHT" value="2" enum="Align">
Aligns the text on the right hand side of the [code]LineEdit[/code].
</constant>
2017-11-24 22:16:30 +00:00
<constant name="ALIGN_FILL" value="3" enum="Align">
Stretches whitespaces to fit the [code]LineEdit[/code]'s width.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MENU_CUT" value="0" enum="MenuItems">
Cuts (copies and clears) the selected text.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MENU_COPY" value="1" enum="MenuItems">
2017-10-27 22:00:22 +00:00
Copies the selected text.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MENU_PASTE" value="2" enum="MenuItems">
2017-10-27 22:00:22 +00:00
Pastes the clipboard text over the selected text (or at the cursor's position).
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MENU_CLEAR" value="3" enum="MenuItems">
Erases the whole [code]LineEdit[/code] text.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MENU_SELECT_ALL" value="4" enum="MenuItems">
Selects the whole [code]LineEdit[/code] text.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MENU_UNDO" value="5" enum="MenuItems">
2017-10-27 22:00:22 +00:00
Undoes the previous action.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MENU_REDO" value="6" enum="MenuItems">
Reverse the last undo action.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MENU_MAX" value="7" enum="MenuItems">
</constant>
</constants>
<theme_items>
2018-08-20 22:35:30 +00:00
<theme_item name="clear" type="Texture">
</theme_item>
<theme_item name="clear_button_color" type="Color">
</theme_item>
<theme_item name="clear_button_color_pressed" type="Color">
</theme_item>
<theme_item name="cursor_color" type="Color">
</theme_item>
<theme_item name="focus" type="StyleBox">
</theme_item>
<theme_item name="font" type="Font">
</theme_item>
<theme_item name="font_color" type="Color">
</theme_item>
<theme_item name="font_color_selected" type="Color">
</theme_item>
<theme_item name="minimum_spaces" type="int">
</theme_item>
<theme_item name="normal" type="StyleBox">
</theme_item>
<theme_item name="read_only" type="StyleBox">
</theme_item>
<theme_item name="selection_color" type="Color">
</theme_item>
</theme_items>
</class>