godotengine/godot-docs-l10n
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs-l10n.git synced 2025-12-31 09:49:22 +03:00
Code Issues Packages Projects Releases Wiki Activity
Files
4.x
godot-docs-l10n/classes/ru/class_lineedit.rst
Rémi Verschelde c3f2364c10 Sync classref with 4.6 branch 
Lots of translations invalidated (fuzzied) as we just synced Weblate.
2025-12-19 16:39:51 +01:00

1977 lines
104 KiB
ReStructuredText
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

:github_url: hide
.. meta::
:keywords: text, input
.. _class_LineEdit:
LineEdit
========
**Наследует:** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
Поле ввода для однострочного текста.
.. rst-class:: classref-introduction-group
Описание
----------------
**LineEdit** предоставляет поле ввода для редактирования одной строки текста.
- Когда элемент управления **LineEdit** сфокусирован с помощью клавиш со стрелками на клавиатуре, он только получит фокус, но не перейдет в режим редактирования.
- Чтобы войти в режим редактирования, щелкните элемент управления мышью, см. также :ref:`keep_editing_on_text_submit<class_LineEdit_property_keep_editing_on_text_submit>`.
- Чтобы выйти из режима редактирования, нажмите ``ui_text_submit`` или ``ui_cancel`` (по умолчанию :kbd:`Escape`) действия.
- Проверьте :ref:`edit()<class_LineEdit_method_edit>`, :ref:`unedit()<class_LineEdit_method_unedit>`, :ref:`is_editing()<class_LineEdit_method_is_editing>` и :ref:`editing_toggled<class_LineEdit_signal_editing_toggled>` для получения дополнительной информации.
При вводе текста можно вставлять специальные символы с помощью альтернативных кодов Unicode, OEM или Windows:
- Чтобы ввести кодовые точки Unicode, удерживайте :kbd:`Alt` и введите кодовую точку на цифровой клавиатуре. Например, чтобы ввести символ ``á`` (U+00E1), удерживайте :kbd:`Alt` и введите :kbd:`+E1` на цифровой клавиатуре (начальные нули можно опустить).
- Чтобы ввести кодовые точки OEM, удерживайте :kbd:`Alt` и введите код на цифровой клавиатуре. Например, чтобы ввести символ ``á`` (OEM 160), удерживайте :kbd:`Alt` и введите ``160`` на цифровой клавиатуре.
- Чтобы ввести кодовые точки Windows, удерживайте :kbd:`Alt` и введите код на цифровой клавиатуре. Например, чтобы ввести символ ``á`` (Windows 0225), удерживайте :kbd:`Alt` и введите :kbd:`0`, :kbd:`2`, :kbd:`2`, :kbd:`5` на цифровой клавиатуре. Начальный ноль здесь **не** должен быть опущен, так как именно так кодовые точки Windows отличаются от кодовых точек OEM.
\ **Важно:**\
- Фокусировка **LineEdit** с помощью ``ui_focus_next`` (по умолчанию :kbd:`Tab`) или ``ui_focus_prev`` (по умолчанию :kbd:`Shift + Tab`) или :ref:`Control.grab_focus()<class_Control_method_grab_focus>` по-прежнему переходит в режим редактирования (для совместимости).
\ **LineEdit** содержит множество встроенных сочетаний клавиш, которые всегда доступны (:kbd:`Ctrl` здесь соответствует :kbd:`Cmd` на macOS):
- :kbd:`Ctrl + C`: Копировать
- :kbd:`Ctrl + X`: Вырезать
- :kbd:`Ctrl + V` или :kbd:`Ctrl + Y`: Вставить/"сбросить"
- :kbd:`Ctrl + Z`: Отменить
- :kbd:`Ctrl + ~`: Поменять направление ввода.
- :kbd:`Ctrl + Shift + Z`: Повторить
- :kbd:`Ctrl + U`: Удалить текст от позиции каретки до начала строки
- :kbd:`Ctrl + K`: Удалить текст от позиции каретки до конца строки
- :kbd:`Ctrl + A`: Выделить весь текст
- :kbd:`Up Arrow`/:kbd:`Down Arrow`: Переместить каретку в начало/конец строки
В macOS доступны некоторые дополнительные сочетания клавиш:
- :kbd:`Cmd + F`: То же, что и :kbd:`Стрелка вправо`, переместить каретку на один символ вправо
- :kbd:`Cmd + B`: То же, что и :kbd:`Стрелка влево`, переместить курсор на один символ влево
- :kbd:`Cmd + P`: То же, что :kbd:`Стрелка вверх`, переместить курсор на предыдущую строку
- :kbd:`Cmd + N`: То же, что :kbd:`Стрелка вниз`, переместить курсор на следующую строку
- :kbd:`Cmd + D`: То же, что :kbd:`Delete`, удалить символ справа от курсора
- :kbd:`Cmd + H`: То же, что :kbd:`Backspace`, удалить символ слева от курсора
- :kbd:`Cmd + A`: То же, что :kbd:`Home`, переместить курсор в начало строки
- :kbd:`Cmd + E`: То же, что :kbd:`End`, переместить курсор в конец строки
- :kbd:`Cmd + Left Arrow`: То же, что :kbd:`Home`, переместить курсор в начало строки
- :kbd:`Cmd + Right Arrow`: То же, что :kbd:`End`, переместить курсор в конец строки
\ **Примечание:** Перечисленные выше сочетания клавиш для перемещения курсора не зависят от :ref:`shortcut_keys_enabled<class_LineEdit_property_shortcut_keys_enabled>`.
.. rst-class:: classref-reftable-group
Свойства
----------------
.. table::
:widths: auto
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` | :ref:`alignment<class_LineEdit_property_alignment>` | ``0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`backspace_deletes_composite_character_enabled<class_LineEdit_property_backspace_deletes_composite_character_enabled>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`caret_blink<class_LineEdit_property_caret_blink>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`caret_blink_interval<class_LineEdit_property_caret_blink_interval>` | ``0.65`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`caret_column<class_LineEdit_property_caret_column>` | ``0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`caret_force_displayed<class_LineEdit_property_caret_force_displayed>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`caret_mid_grapheme<class_LineEdit_property_caret_mid_grapheme>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`clear_button_enabled<class_LineEdit_property_clear_button_enabled>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`context_menu_enabled<class_LineEdit_property_context_menu_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`deselect_on_focus_loss_enabled<class_LineEdit_property_deselect_on_focus_loss_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`drag_and_drop_selection_enabled<class_LineEdit_property_drag_and_drop_selection_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`draw_control_chars<class_LineEdit_property_draw_control_chars>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`editable<class_LineEdit_property_editable>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`emoji_menu_enabled<class_LineEdit_property_emoji_menu_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`expand_to_text_length<class_LineEdit_property_expand_to_text_length>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`flat<class_LineEdit_property_flat>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`FocusMode<enum_Control_FocusMode>` | focus_mode | ``2`` (overrides :ref:`Control<class_Control_property_focus_mode>`) |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`ExpandMode<enum_LineEdit_ExpandMode>` | :ref:`icon_expand_mode<class_LineEdit_property_icon_expand_mode>` | ``0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`keep_editing_on_text_submit<class_LineEdit_property_keep_editing_on_text_submit>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`language<class_LineEdit_property_language>` | ``""`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`max_length<class_LineEdit_property_max_length>` | ``0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`middle_mouse_paste_enabled<class_LineEdit_property_middle_mouse_paste_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`CursorShape<enum_Control_CursorShape>` | mouse_default_cursor_shape | ``1`` (overrides :ref:`Control<class_Control_property_mouse_default_cursor_shape>`) |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`placeholder_text<class_LineEdit_property_placeholder_text>` | ``""`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`right_icon<class_LineEdit_property_right_icon>` | |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`right_icon_scale<class_LineEdit_property_right_icon_scale>` | ``1.0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`secret<class_LineEdit_property_secret>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`secret_character<class_LineEdit_property_secret_character>` | ``"•"`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`select_all_on_focus<class_LineEdit_property_select_all_on_focus>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`selecting_enabled<class_LineEdit_property_selecting_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`shortcut_keys_enabled<class_LineEdit_property_shortcut_keys_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` | :ref:`structured_text_bidi_override<class_LineEdit_property_structured_text_bidi_override>` | ``0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`Array<class_Array>` | :ref:`structured_text_bidi_override_options<class_LineEdit_property_structured_text_bidi_override_options>` | ``[]`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`text<class_LineEdit_property_text>` | ``""`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`TextDirection<enum_Control_TextDirection>` | :ref:`text_direction<class_LineEdit_property_text_direction>` | ``0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`virtual_keyboard_enabled<class_LineEdit_property_virtual_keyboard_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`virtual_keyboard_show_on_focus<class_LineEdit_property_virtual_keyboard_show_on_focus>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` | :ref:`virtual_keyboard_type<class_LineEdit_property_virtual_keyboard_type>` | ``0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
.. rst-class:: classref-reftable-group
Методы
------------
.. table::
:widths: auto
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`apply_ime<class_LineEdit_method_apply_ime>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`cancel_ime<class_LineEdit_method_cancel_ime>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`clear<class_LineEdit_method_clear>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`delete_char_at_caret<class_LineEdit_method_delete_char_at_caret>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`delete_text<class_LineEdit_method_delete_text>`\ (\ from_column\: :ref:`int<class_int>`, to_column\: :ref:`int<class_int>`\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`deselect<class_LineEdit_method_deselect>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`edit<class_LineEdit_method_edit>`\ (\ hide_focus\: :ref:`bool<class_bool>` = false\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`PopupMenu<class_PopupMenu>` | :ref:`get_menu<class_LineEdit_method_get_menu>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_next_composite_character_column<class_LineEdit_method_get_next_composite_character_column>`\ (\ column\: :ref:`int<class_int>`\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_previous_composite_character_column<class_LineEdit_method_get_previous_composite_character_column>`\ (\ column\: :ref:`int<class_int>`\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_scroll_offset<class_LineEdit_method_get_scroll_offset>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_selected_text<class_LineEdit_method_get_selected_text>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_selection_from_column<class_LineEdit_method_get_selection_from_column>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_selection_to_column<class_LineEdit_method_get_selection_to_column>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_ime_text<class_LineEdit_method_has_ime_text>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_redo<class_LineEdit_method_has_redo>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_selection<class_LineEdit_method_has_selection>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_undo<class_LineEdit_method_has_undo>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`insert_text_at_caret<class_LineEdit_method_insert_text_at_caret>`\ (\ text\: :ref:`String<class_String>`\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_editing<class_LineEdit_method_is_editing>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_menu_visible<class_LineEdit_method_is_menu_visible>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`menu_option<class_LineEdit_method_menu_option>`\ (\ option\: :ref:`int<class_int>`\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`select<class_LineEdit_method_select>`\ (\ from\: :ref:`int<class_int>` = 0, to\: :ref:`int<class_int>` = -1\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`select_all<class_LineEdit_method_select_all>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`unedit<class_LineEdit_method_unedit>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-reftable-group
Свойства темы
--------------------------
.. table::
:widths: auto
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`caret_color<class_LineEdit_theme_color_caret_color>` | ``Color(0.95, 0.95, 0.95, 1)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`clear_button_color<class_LineEdit_theme_color_clear_button_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`clear_button_color_pressed<class_LineEdit_theme_color_clear_button_color_pressed>` | ``Color(1, 1, 1, 1)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_color<class_LineEdit_theme_color_font_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_outline_color<class_LineEdit_theme_color_font_outline_color>` | ``Color(0, 0, 0, 1)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_placeholder_color<class_LineEdit_theme_color_font_placeholder_color>` | ``Color(0.875, 0.875, 0.875, 0.6)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_selected_color<class_LineEdit_theme_color_font_selected_color>` | ``Color(1, 1, 1, 1)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_uneditable_color<class_LineEdit_theme_color_font_uneditable_color>` | ``Color(0.875, 0.875, 0.875, 0.5)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`selection_color<class_LineEdit_theme_color_selection_color>` | ``Color(0.5, 0.5, 0.5, 1)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`int<class_int>` | :ref:`caret_width<class_LineEdit_theme_constant_caret_width>` | ``1`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`int<class_int>` | :ref:`minimum_character_width<class_LineEdit_theme_constant_minimum_character_width>` | ``4`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`int<class_int>` | :ref:`outline_size<class_LineEdit_theme_constant_outline_size>` | ``0`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Font<class_Font>` | :ref:`font<class_LineEdit_theme_font_font>` | |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`int<class_int>` | :ref:`font_size<class_LineEdit_theme_font_size_font_size>` | |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`clear<class_LineEdit_theme_icon_clear>` | |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`focus<class_LineEdit_theme_style_focus>` | |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`normal<class_LineEdit_theme_style_normal>` | |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`read_only<class_LineEdit_theme_style_read_only>` | |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Сигналы
--------------
.. _class_LineEdit_signal_editing_toggled:
.. rst-class:: classref-signal
**editing_toggled**\ (\ toggled_on\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_LineEdit_signal_editing_toggled>`
Вызывается, когда **LineEdit** переключается в режим редактирования или выходит из него.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_signal_text_change_rejected:
.. rst-class:: classref-signal
**text_change_rejected**\ (\ rejected_substring\: :ref:`String<class_String>`\ ) :ref:`🔗<class_LineEdit_signal_text_change_rejected>`
Вызывается при добавлении текста, который выходит за пределы :ref:`max_length<class_LineEdit_property_max_length>`. Добавленный текст усекается, чтобы соответствовать :ref:`max_length<class_LineEdit_property_max_length>`, а часть, которая не помещается, передается как аргумент\ ``rejected_substring``.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_signal_text_changed:
.. rst-class:: classref-signal
**text_changed**\ (\ new_text\: :ref:`String<class_String>`\ ) :ref:`🔗<class_LineEdit_signal_text_changed>`
Выдается при изменении текста.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_signal_text_submitted:
.. rst-class:: classref-signal
**text_submitted**\ (\ new_text\: :ref:`String<class_String>`\ ) :ref:`🔗<class_LineEdit_signal_text_submitted>`
Вызывается, когда пользователь нажимает действие ``ui_text_submit`` (по умолчанию: :kbd:`Enter` или :kbd:`Kp Enter`), когда фокус находится на **LineEdit**.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Перечисления
------------------------
.. _enum_LineEdit_MenuItems:
.. rst-class:: classref-enumeration
enum **MenuItems**: :ref:`🔗<enum_LineEdit_MenuItems>`
.. _class_LineEdit_constant_MENU_CUT:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_CUT** = ``0``
Вырезает (копирует и очищает) выделенный текст.
.. _class_LineEdit_constant_MENU_COPY:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_COPY** = ``1``
Копирует выделенный текст.
.. _class_LineEdit_constant_MENU_PASTE:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_PASTE** = ``2``
Вставляет текст буфера обмена поверх выделенного текста (или в позицию курсора).
Непечатаемые экранированные символы автоматически удаляются из буфера обмена ОС с помощью :ref:`String.strip_escapes()<class_String_method_strip_escapes>`.
.. _class_LineEdit_constant_MENU_CLEAR:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_CLEAR** = ``3``
Стирает весь текст **LineEdit**.
.. _class_LineEdit_constant_MENU_SELECT_ALL:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_SELECT_ALL** = ``4``
Выделяет весь текст **LineEdit**.
.. _class_LineEdit_constant_MENU_UNDO:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_UNDO** = ``5``
Отменяет предыдущее действие.
.. _class_LineEdit_constant_MENU_REDO:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_REDO** = ``6``
Отменить последнее отмененное действие.
.. _class_LineEdit_constant_MENU_SUBMENU_TEXT_DIR:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_SUBMENU_TEXT_DIR** = ``7``
Идентификатор подменю «Направление написания текста».
.. _class_LineEdit_constant_MENU_DIR_INHERITED:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_DIR_INHERITED** = ``8``
Устанавливает унаследованное направление текста.
.. _class_LineEdit_constant_MENU_DIR_AUTO:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_DIR_AUTO** = ``9``
Устанавливает автоматическое направление текста.
.. _class_LineEdit_constant_MENU_DIR_LTR:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_DIR_LTR** = ``10``
Устанавливает направление текста слева направо.
.. _class_LineEdit_constant_MENU_DIR_RTL:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_DIR_RTL** = ``11``
Устанавливает направление текста справа налево.
.. _class_LineEdit_constant_MENU_DISPLAY_UCC:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_DISPLAY_UCC** = ``12``
Переключает отображение управляющего символа.
.. _class_LineEdit_constant_MENU_SUBMENU_INSERT_UCC:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_SUBMENU_INSERT_UCC** = ``13``
Идентификатор подменю «Вставить управляющий символ».
.. _class_LineEdit_constant_MENU_INSERT_LRM:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_LRM** = ``14``
Вставляет символ знака слева направо (LRM).
.. _class_LineEdit_constant_MENU_INSERT_RLM:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_RLM** = ``15``
Вставляет символ с письмом справа налево (RLM).
.. _class_LineEdit_constant_MENU_INSERT_LRE:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_LRE** = ``16``
Вставляет начало символа вставки слева направо (LRE).
.. _class_LineEdit_constant_MENU_INSERT_RLE:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_RLE** = ``17``
Вставляет начало символа вставки справа налево (RLE).
.. _class_LineEdit_constant_MENU_INSERT_LRO:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_LRO** = ``18``
Вставляет начало символа переопределения слева направо (LRO).
.. _class_LineEdit_constant_MENU_INSERT_RLO:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_RLO** = ``19``
Вставляет начало символа переопределения справа налево (RLO).
.. _class_LineEdit_constant_MENU_INSERT_PDF:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_PDF** = ``20``
Вставляет символ форматирования направления поп-арта (PDF).
.. _class_LineEdit_constant_MENU_INSERT_ALM:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_ALM** = ``21``
Вставляет символ арабской буквы (ALM).
.. _class_LineEdit_constant_MENU_INSERT_LRI:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_LRI** = ``22``
Вставляет изолирующий символ слева направо (LRI).
.. _class_LineEdit_constant_MENU_INSERT_RLI:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_RLI** = ``23``
Вставляет изолирующий символ справа налево (RLI).
.. _class_LineEdit_constant_MENU_INSERT_FSI:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_FSI** = ``24``
Вставляет первый сильный изолятный (FSI) символ.
.. _class_LineEdit_constant_MENU_INSERT_PDI:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_PDI** = ``25``
Вставляет символ изоляции направления поп-музыки (PDI).
.. _class_LineEdit_constant_MENU_INSERT_ZWJ:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_ZWJ** = ``26``
Вставляет символ объединения нулевой ширины (ZWJ).
.. _class_LineEdit_constant_MENU_INSERT_ZWNJ:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_ZWNJ** = ``27``
Вставляет символ нулевой ширины, не являющийся объединяющим (ZWNJ).
.. _class_LineEdit_constant_MENU_INSERT_WJ:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_WJ** = ``28``
Вставляет символ объединения слов (WJ).
.. _class_LineEdit_constant_MENU_INSERT_SHY:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_SHY** = ``29``
Вставляет символ мягкого дефиса (SHY).
.. _class_LineEdit_constant_MENU_EMOJI_AND_SYMBOL:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_EMOJI_AND_SYMBOL** = ``30``
Открывает системный выбор эмодзи и символов.
.. _class_LineEdit_constant_MENU_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_MAX** = ``31``
Представляет размер перечисления :ref:`MenuItems<enum_LineEdit_MenuItems>`.
.. rst-class:: classref-item-separator
----
.. _enum_LineEdit_VirtualKeyboardType:
.. rst-class:: classref-enumeration
enum **VirtualKeyboardType**: :ref:`🔗<enum_LineEdit_VirtualKeyboardType>`
.. _class_LineEdit_constant_KEYBOARD_TYPE_DEFAULT:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_DEFAULT** = ``0``
Текстовая виртуальная клавиатура по умолчанию.
.. _class_LineEdit_constant_KEYBOARD_TYPE_MULTILINE:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_MULTILINE** = ``1``
Многострочная виртуальная клавиатура.
.. _class_LineEdit_constant_KEYBOARD_TYPE_NUMBER:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_NUMBER** = ``2``
Виртуальная цифровая клавиатура, полезная для ввода ПИН-кода.
.. _class_LineEdit_constant_KEYBOARD_TYPE_NUMBER_DECIMAL:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_NUMBER_DECIMAL** = ``3``
Виртуальная цифровая клавиатура, полезная для ввода дробных чисел.
.. _class_LineEdit_constant_KEYBOARD_TYPE_PHONE:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_PHONE** = ``4``
Виртуальная клавиатура для набора номера телефона.
.. _class_LineEdit_constant_KEYBOARD_TYPE_EMAIL_ADDRESS:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_EMAIL_ADDRESS** = ``5``
Виртуальная клавиатура с дополнительными клавишами для облегчения ввода адресов электронной почты.
.. _class_LineEdit_constant_KEYBOARD_TYPE_PASSWORD:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_PASSWORD** = ``6``
Виртуальная клавиатура для ввода пароля. На большинстве платформ это должно отключить автозаполнение и автоматическую капитализацию.
\ **Примечание:** Это не поддерживается в Web. Вместо этого это ведет себя идентично :ref:`KEYBOARD_TYPE_DEFAULT<class_LineEdit_constant_KEYBOARD_TYPE_DEFAULT>`.
.. _class_LineEdit_constant_KEYBOARD_TYPE_URL:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_URL** = ``7``
Виртуальная клавиатура с дополнительными клавишами для облегчения ввода URL-адресов.
.. rst-class:: classref-item-separator
----
.. _enum_LineEdit_ExpandMode:
.. rst-class:: classref-enumeration
enum **ExpandMode**: :ref:`🔗<enum_LineEdit_ExpandMode>`
.. _class_LineEdit_constant_EXPAND_MODE_ORIGINAL_SIZE:
.. rst-class:: classref-enumeration-constant
:ref:`ExpandMode<enum_LineEdit_ExpandMode>` **EXPAND_MODE_ORIGINAL_SIZE** = ``0``
Use the original size for the right icon.
.. _class_LineEdit_constant_EXPAND_MODE_FIT_TO_TEXT:
.. rst-class:: classref-enumeration-constant
:ref:`ExpandMode<enum_LineEdit_ExpandMode>` **EXPAND_MODE_FIT_TO_TEXT** = ``1``
Scale the right icon's size to match the size of the text.
.. _class_LineEdit_constant_EXPAND_MODE_FIT_TO_LINE_EDIT:
.. rst-class:: classref-enumeration-constant
:ref:`ExpandMode<enum_LineEdit_ExpandMode>` **EXPAND_MODE_FIT_TO_LINE_EDIT** = ``2``
Scale the right icon to fit the LineEdit.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Описания свойств
--------------------------------
.. _class_LineEdit_property_alignment:
.. rst-class:: classref-property
:ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **alignment** = ``0`` :ref:`🔗<class_LineEdit_property_alignment>`
.. rst-class:: classref-property-setget
- |void| **set_horizontal_alignment**\ (\ value\: :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>`\ )
- :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **get_horizontal_alignment**\ (\ )
The text's horizontal alignment.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_backspace_deletes_composite_character_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **backspace_deletes_composite_character_enabled** = ``false`` :ref:`🔗<class_LineEdit_property_backspace_deletes_composite_character_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_backspace_deletes_composite_character_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_backspace_deletes_composite_character_enabled**\ (\ )
Если ``true`` и :ref:`caret_mid_grapheme<class_LineEdit_property_caret_mid_grapheme>` в значении ``false``, Возврат удаляет весь составной символ, такой как ❤️‍🩹, вместо удаления части составного символа.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_caret_blink:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **caret_blink** = ``false`` :ref:`🔗<class_LineEdit_property_caret_blink>`
.. rst-class:: classref-property-setget
- |void| **set_caret_blink_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_caret_blink_enabled**\ (\ )
Если ``true``, курсор мигает.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_caret_blink_interval:
.. rst-class:: classref-property
:ref:`float<class_float>` **caret_blink_interval** = ``0.65`` :ref:`🔗<class_LineEdit_property_caret_blink_interval>`
.. rst-class:: classref-property-setget
- |void| **set_caret_blink_interval**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_caret_blink_interval**\ (\ )
Интервал мигания курсора (в секундах).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_caret_column:
.. rst-class:: classref-property
:ref:`int<class_int>` **caret_column** = ``0`` :ref:`🔗<class_LineEdit_property_caret_column>`
.. rst-class:: classref-property-setget
- |void| **set_caret_column**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_caret_column**\ (\ )
Положение столбца курсора внутри **LineEdit**. Если установлено, текст может прокручиваться, чтобы вместить его.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_caret_force_displayed:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **caret_force_displayed** = ``false`` :ref:`🔗<class_LineEdit_property_caret_force_displayed>`
.. rst-class:: classref-property-setget
- |void| **set_caret_force_displayed**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_caret_force_displayed**\ (\ )
Если ``true``, **LineEdit** всегда будет отображать курсор, даже если редактирование не выполняется или фокус потерян.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_caret_mid_grapheme:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **caret_mid_grapheme** = ``false`` :ref:`🔗<class_LineEdit_property_caret_mid_grapheme>`
.. rst-class:: classref-property-setget
- |void| **set_caret_mid_grapheme_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_caret_mid_grapheme_enabled**\ (\ )
Разрешить перемещение курсора, выбор и удаление отдельных компонентов составного символа.
\ **Примечание:** :kbd:`Backspace` всегда удаляет отдельные компоненты составного символа.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_clear_button_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **clear_button_enabled** = ``false`` :ref:`🔗<class_LineEdit_property_clear_button_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_clear_button_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_clear_button_enabled**\ (\ )
Если ``true``, **LineEdit** отобразит кнопку очистки, если :ref:`text<class_LineEdit_property_text>` не пуст, что можно использовать для быстрой очистки текста.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_context_menu_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **context_menu_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_context_menu_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_context_menu_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_context_menu_enabled**\ (\ )
Если ``true``, при щелчке правой кнопкой мыши появится контекстное меню.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_deselect_on_focus_loss_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **deselect_on_focus_loss_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_deselect_on_focus_loss_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_deselect_on_focus_loss_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_deselect_on_focus_loss_enabled**\ (\ )
Если ``true``, выделенный текст будет снят с выделения при потере фокуса.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_drag_and_drop_selection_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **drag_and_drop_selection_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_drag_and_drop_selection_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_drag_and_drop_selection_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_drag_and_drop_selection_enabled**\ (\ )
Если ``true``, разрешено перетаскивание выделенного текста.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_draw_control_chars:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **draw_control_chars** = ``false`` :ref:`🔗<class_LineEdit_property_draw_control_chars>`
.. rst-class:: classref-property-setget
- |void| **set_draw_control_chars**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_draw_control_chars**\ (\ )
Если ``true``, отображаются управляющие символы.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_editable:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **editable** = ``true`` :ref:`🔗<class_LineEdit_property_editable>`
.. rst-class:: classref-property-setget
- |void| **set_editable**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_editable**\ (\ )
Если ``false``, существующий текст не может быть изменен и новый текст не может быть добавлен.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_emoji_menu_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **emoji_menu_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_emoji_menu_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_emoji_menu_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_emoji_menu_enabled**\ (\ )
Если ``true``, меню «Эмодзи и символы» включено.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_expand_to_text_length:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **expand_to_text_length** = ``false`` :ref:`🔗<class_LineEdit_property_expand_to_text_length>`
.. rst-class:: classref-property-setget
- |void| **set_expand_to_text_length_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_expand_to_text_length_enabled**\ (\ )
Если ``true``, ширина **LineEdit** увеличится и останется длиннее, чем :ref:`text<class_LineEdit_property_text>`. Он **не** сожмется, если :ref:`text<class_LineEdit_property_text>` будет сокращен.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_flat:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **flat** = ``false`` :ref:`🔗<class_LineEdit_property_flat>`
.. rst-class:: classref-property-setget
- |void| **set_flat**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_flat**\ (\ )
Если ``true``, **LineEdit** не отображает оформление.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_icon_expand_mode:
.. rst-class:: classref-property
:ref:`ExpandMode<enum_LineEdit_ExpandMode>` **icon_expand_mode** = ``0`` :ref:`🔗<class_LineEdit_property_icon_expand_mode>`
.. rst-class:: classref-property-setget
- |void| **set_icon_expand_mode**\ (\ value\: :ref:`ExpandMode<enum_LineEdit_ExpandMode>`\ )
- :ref:`ExpandMode<enum_LineEdit_ExpandMode>` **get_icon_expand_mode**\ (\ )
Define the scaling behavior of the :ref:`right_icon<class_LineEdit_property_right_icon>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_keep_editing_on_text_submit:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **keep_editing_on_text_submit** = ``false`` :ref:`🔗<class_LineEdit_property_keep_editing_on_text_submit>`
.. rst-class:: classref-property-setget
- |void| **set_keep_editing_on_text_submit**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_editing_kept_on_text_submit**\ (\ )
Если ``true``, **LineEdit** не выйдет из режима редактирования, если текст отправлен нажатием действия ``ui_text_submit`` (по умолчанию: :kbd:`Enter` или :kbd:`Kp Enter`).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_language:
.. rst-class:: classref-property
:ref:`String<class_String>` **language** = ``""`` :ref:`🔗<class_LineEdit_property_language>`
.. rst-class:: classref-property-setget
- |void| **set_language**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_language**\ (\ )
Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_max_length:
.. rst-class:: classref-property
:ref:`int<class_int>` **max_length** = ``0`` :ref:`🔗<class_LineEdit_property_max_length>`
.. rst-class:: classref-property-setget
- |void| **set_max_length**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_max_length**\ (\ )
Максимальное количество символов, которое можно ввести в **LineEdit**. Если ``0``, ограничений нет.
Если задано ограничение, символы, превышающие :ref:`max_length<class_LineEdit_property_max_length>`, обрезаются. Это происходит как с существующим содержимым :ref:`text<class_LineEdit_property_text>` при установке максимальной длины, так и с новым текстом, вставленным в **LineEdit**, включая вставку.
Если какой-либо введённый текст обрезается, выдаётся сигнал :ref:`text_change_rejected<class_LineEdit_signal_text_change_rejected>` с обрезанной подстрокой в качестве параметра:
.. tabs::
.. code-tab:: gdscript
text = "Hello world"
max_length = 5
# `text` становится "Hello".
max_length = 10
text += " goodbye"
# `text` становится "Hello good".
# `text_change_rejected` выдается с параметром "bye".
.. code-tab:: csharp
Text = "Hello world";
MaxLength = 5;
// `Text` становится "Hello".
MaxLength = 10;
Text += " goodbye";
// `Text` становится "Hello good".
// `text_change_rejected` выдается с параметром "bye".
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_middle_mouse_paste_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **middle_mouse_paste_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_middle_mouse_paste_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_middle_mouse_paste_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_middle_mouse_paste_enabled**\ (\ )
Если ``false``, использование средней кнопки мыши для вставки буфера обмена будет отключено.
\ **Примечание:** Этот метод реализован только в Linux.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_placeholder_text:
.. rst-class:: classref-property
:ref:`String<class_String>` **placeholder_text** = ``""`` :ref:`🔗<class_LineEdit_property_placeholder_text>`
.. rst-class:: classref-property-setget
- |void| **set_placeholder**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_placeholder**\ (\ )
Текст, отображаемый, когда **LineEdit** пуст. Это **не** значение по умолчанию для **LineEdit** (см. :ref:`text<class_LineEdit_property_text>`).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_right_icon:
.. rst-class:: classref-property
:ref:`Texture2D<class_Texture2D>` **right_icon** :ref:`🔗<class_LineEdit_property_right_icon>`
.. rst-class:: classref-property-setget
- |void| **set_right_icon**\ (\ value\: :ref:`Texture2D<class_Texture2D>`\ )
- :ref:`Texture2D<class_Texture2D>` **get_right_icon**\ (\ )
Устанавливает значок, который будет отображаться в правом конце **LineEdit**, если нет :ref:`text<class_LineEdit_property_text>`, или всегда, если :ref:`clear_button_enabled<class_LineEdit_property_clear_button_enabled>` установлен в ``false``.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_right_icon_scale:
.. rst-class:: classref-property
:ref:`float<class_float>` **right_icon_scale** = ``1.0`` :ref:`🔗<class_LineEdit_property_right_icon_scale>`
.. rst-class:: classref-property-setget
- |void| **set_right_icon_scale**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_right_icon_scale**\ (\ )
Scale ratio of the icon when :ref:`icon_expand_mode<class_LineEdit_property_icon_expand_mode>` is set to :ref:`EXPAND_MODE_FIT_TO_LINE_EDIT<class_LineEdit_constant_EXPAND_MODE_FIT_TO_LINE_EDIT>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_secret:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **secret** = ``false`` :ref:`🔗<class_LineEdit_property_secret>`
.. rst-class:: classref-property-setget
- |void| **set_secret**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_secret**\ (\ )
Если ``true``, каждый символ заменяется секретным символом (см. :ref:`secret_character<class_LineEdit_property_secret_character>`).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_secret_character:
.. rst-class:: classref-property
:ref:`String<class_String>` **secret_character** = ``"•"`` :ref:`🔗<class_LineEdit_property_secret_character>`
.. rst-class:: classref-property-setget
- |void| **set_secret_character**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_secret_character**\ (\ )
Символ, используемый для маскировки секретного ввода. В качестве секретного символа можно использовать только один символ. Если он длиннее одного символа, будет использоваться только первый. Если он пустой, вместо него будет использоваться пробел.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_select_all_on_focus:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **select_all_on_focus** = ``false`` :ref:`🔗<class_LineEdit_property_select_all_on_focus>`
.. rst-class:: classref-property-setget
- |void| **set_select_all_on_focus**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_select_all_on_focus**\ (\ )
Если ``true``, **LineEdit** выделит весь текст, когда получит фокус.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_selecting_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **selecting_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_selecting_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_selecting_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_selecting_enabled**\ (\ )
Если ``false``, невозможно выделить текст с помощью мыши или клавиатуры.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_shortcut_keys_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **shortcut_keys_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_shortcut_keys_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_shortcut_keys_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_shortcut_keys_enabled**\ (\ )
Если ``true``, сочетания клавиш для пунктов контекстного меню включены, даже если контекстное меню отключено.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_structured_text_bidi_override:
.. rst-class:: classref-property
:ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **structured_text_bidi_override** = ``0`` :ref:`🔗<class_LineEdit_property_structured_text_bidi_override>`
.. rst-class:: classref-property-setget
- |void| **set_structured_text_bidi_override**\ (\ value\: :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>`\ )
- :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **get_structured_text_bidi_override**\ (\ )
Установите переопределение алгоритма BiDi для структурированного текста.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_structured_text_bidi_override_options:
.. rst-class:: classref-property
:ref:`Array<class_Array>` **structured_text_bidi_override_options** = ``[]`` :ref:`🔗<class_LineEdit_property_structured_text_bidi_override_options>`
.. rst-class:: classref-property-setget
- |void| **set_structured_text_bidi_override_options**\ (\ value\: :ref:`Array<class_Array>`\ )
- :ref:`Array<class_Array>` **get_structured_text_bidi_override_options**\ (\ )
Установите дополнительные параметры для переопределения BiDi.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_text:
.. rst-class:: classref-property
:ref:`String<class_String>` **text** = ``""`` :ref:`🔗<class_LineEdit_property_text>`
.. rst-class:: classref-property-setget
- |void| **set_text**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_text**\ (\ )
Строковое значение **LineEdit**.
\ **Примечание:** Изменение текста с использованием этого свойства не будет генерировать сигнал :ref:`text_changed<class_LineEdit_signal_text_changed>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_text_direction:
.. rst-class:: classref-property
:ref:`TextDirection<enum_Control_TextDirection>` **text_direction** = ``0`` :ref:`🔗<class_LineEdit_property_text_direction>`
.. rst-class:: classref-property-setget
- |void| **set_text_direction**\ (\ value\: :ref:`TextDirection<enum_Control_TextDirection>`\ )
- :ref:`TextDirection<enum_Control_TextDirection>` **get_text_direction**\ (\ )
Направление написания базового текста.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_virtual_keyboard_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **virtual_keyboard_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_virtual_keyboard_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_virtual_keyboard_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_virtual_keyboard_enabled**\ (\ )
Если ``true``, встроенная виртуальная клавиатура включена на платформах, которые ее поддерживают.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_virtual_keyboard_show_on_focus:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **virtual_keyboard_show_on_focus** = ``true`` :ref:`🔗<class_LineEdit_property_virtual_keyboard_show_on_focus>`
.. rst-class:: classref-property-setget
- |void| **set_virtual_keyboard_show_on_focus**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_virtual_keyboard_show_on_focus**\ (\ )
Если ``true``, то собственная виртуальная клавиатура отображается при фокусировке на платформах, которые ее поддерживают.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_virtual_keyboard_type:
.. rst-class:: classref-property
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **virtual_keyboard_type** = ``0`` :ref:`🔗<class_LineEdit_property_virtual_keyboard_type>`
.. rst-class:: classref-property-setget
- |void| **set_virtual_keyboard_type**\ (\ value\: :ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>`\ )
- :ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **get_virtual_keyboard_type**\ (\ )
Указывает тип отображаемой виртуальной клавиатуры.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Описания метода
------------------------------
.. _class_LineEdit_method_apply_ime:
.. rst-class:: classref-method
|void| **apply_ime**\ (\ ) :ref:`🔗<class_LineEdit_method_apply_ime>`
Применяет текст из `редактора метода ввода <https://en.wikipedia.org/wiki/Input_method>`__ (IME) и закрывает IME, если он открыт.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_cancel_ime:
.. rst-class:: classref-method
|void| **cancel_ime**\ (\ ) :ref:`🔗<class_LineEdit_method_cancel_ime>`
Закрывает `Редактор метода ввода <https://en.wikipedia.org/wiki/Input_method>`__ (IME), если он открыт. Любой текст в IME будет потерян.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_clear:
.. rst-class:: classref-method
|void| **clear**\ (\ ) :ref:`🔗<class_LineEdit_method_clear>`
Удаляет :ref:`text<class_LineEdit_property_text>` **LineEdit**-s.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_delete_char_at_caret:
.. rst-class:: classref-method
|void| **delete_char_at_caret**\ (\ ) :ref:`🔗<class_LineEdit_method_delete_char_at_caret>`
Удаляет один символ в текущей позиции курсора (эквивалентно нажатию :kbd:`Delete`).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_delete_text:
.. rst-class:: classref-method
|void| **delete_text**\ (\ from_column\: :ref:`int<class_int>`, to_column\: :ref:`int<class_int>`\ ) :ref:`🔗<class_LineEdit_method_delete_text>`
Удаляет часть :ref:`text<class_LineEdit_property_text>`, начиная с позиции ``from_column`` до ``to_column``. Оба параметра должны быть в пределах длины текста.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_deselect:
.. rst-class:: classref-method
|void| **deselect**\ (\ ) :ref:`🔗<class_LineEdit_method_deselect>`
Очищает текущий выбор.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_edit:
.. rst-class:: classref-method
|void| **edit**\ (\ hide_focus\: :ref:`bool<class_bool>` = false\ ) :ref:`🔗<class_LineEdit_method_edit>`
Allows entering edit mode whether the **LineEdit** is focused or not. If ``hide_focus`` is ``true``, the focused state will not be shown (see :ref:`Control.grab_focus()<class_Control_method_grab_focus>`).
See also :ref:`keep_editing_on_text_submit<class_LineEdit_property_keep_editing_on_text_submit>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_get_menu:
.. rst-class:: classref-method
:ref:`PopupMenu<class_PopupMenu>` **get_menu**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_get_menu>`
Возвращает :ref:`PopupMenu<class_PopupMenu>` этого **LineEdit**. По умолчанию это меню отображается при щелчке правой кнопкой мыши по **LineEdit**.
Вы можете добавлять пользовательские пункты меню или удалять стандартные. Убедитесь, что ваши идентификаторы не конфликтуют со стандартными (см. :ref:`MenuItems<enum_LineEdit_MenuItems>`). Например:
.. tabs::
.. code-tab:: gdscript
func _ready():
var menu = get_menu()
# Удалить все элементы после «Повторить».
menu.item_count = menu.get_item_index(MENU_REDO) + 1
# Добавьте пользовательские элементы.
menu.add_separator()
menu.add_item("Insert Date", MENU_MAX + 1)
# Подключить обратный вызов.
menu.id_pressed.connect(_on_item_pressed)
func _on_item_pressed(id):
if id == MENU_MAX + 1:
insert_text_at_caret(Time.get_date_string_from_system())
.. code-tab:: csharp
public override void _Ready()
{
var menu = GetMenu();
// Удалить все элементы после «Повторить».
menu.ItemCount = menu.GetItemIndex(LineEdit.MenuItems.Redo) + 1;
// Добавьте пользовательские элементы.
menu.AddSeparator();
menu.AddItem("Insert Date", LineEdit.MenuItems.Max + 1);
// Добавить обработчик событий.
menu.IdPressed += OnItemPressed;
}
public void OnItemPressed(int id)
{
if (id == LineEdit.MenuItems.Max + 1)
{
InsertTextAtCaret(Time.GetDateStringFromSystem());
}
}
\ **Предупреждение:** Это обязательный внутренний узел, его удаление и освобождение может привести к сбою. Если вы хотите скрыть его или любого из его дочерних элементов, используйте их свойство :ref:`Window.visible<class_Window_property_visible>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_get_next_composite_character_column:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_next_composite_character_column**\ (\ column\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_LineEdit_method_get_next_composite_character_column>`
Возвращает правильный столбец в конце составного символа, такого как ❤️‍🩹 (исправление сердца; Unicode: ``U+2764 U+FE0F U+200D U+1FA79``), который состоит из более чем одной точки кода Unicode, если каретка в начале составного символа. Также возвращает правильный столбец с помощью каретки в средней графеме и для некомпозитных символов.
\ ** Примечание: ** Чтобы проверить в использовании местоположения каретки ``get_next_composite_character_column(get_caret_column())``
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_get_previous_composite_character_column:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_previous_composite_character_column**\ (\ column\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_LineEdit_method_get_previous_composite_character_column>`
Возвращает правильный столбец в начале композитного символа, такого как ❤️‍🩹 (исправление сердца; Unicode: ``U+2764 U+FE0F U+200D U+1FA79``), который состоит из более чем одной точки кода Unicode, если каретка находится в конце составного символа. Также возвращает правильный столбец с помощью каретки в средней графеме и для некомпозитных символов.
\ ** Примечание: ** Чтобы проверить в использовании местоположения каретки ``get_previous_composite_character_column(get_caret_column())``
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_get_scroll_offset:
.. rst-class:: classref-method
:ref:`float<class_float>` **get_scroll_offset**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_get_scroll_offset>`
Возвращает смещение прокрутки из-за :ref:`caret_column<class_LineEdit_property_caret_column>` в виде количества символов.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_get_selected_text:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_selected_text**\ (\ ) :ref:`🔗<class_LineEdit_method_get_selected_text>`
Возвращает текст внутри выделения.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_get_selection_from_column:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_selection_from_column**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_get_selection_from_column>`
Возвращает начальный столбец выбора.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_get_selection_to_column:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_selection_to_column**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_get_selection_to_column>`
Возвращает конечный столбец выбора.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_has_ime_text:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_ime_text**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_has_ime_text>`
Возвращает ``true``, если у пользователя есть текст в `редакторе метода ввода <https://en.wikipedia.org/wiki/Input_method>`__ (IME).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_has_redo:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_redo**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_has_redo>`
Возвращает ``true``, если доступно действие «повторить».
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_has_selection:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_selection**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_has_selection>`
Возвращает ``true``, если пользователь выбрал текст.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_has_undo:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_undo**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_has_undo>`
Возвращает ``true``, если доступно действие «отменить».
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_insert_text_at_caret:
.. rst-class:: classref-method
|void| **insert_text_at_caret**\ (\ text\: :ref:`String<class_String>`\ ) :ref:`🔗<class_LineEdit_method_insert_text_at_caret>`
Вставляет ``text`` в каретку. Если полученное значение длиннее, чем :ref:`max_length<class_LineEdit_property_max_length>`, ничего не происходит.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_is_editing:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_editing**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_is_editing>`
Возвращает, редактируется ли **LineEdit**.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_is_menu_visible:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_menu_visible**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_is_menu_visible>`
Возвращает, видимо ли меню. Используйте это вместо ``get_menu().visible`` для повышения производительности (чтобы избежать создания меню).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_menu_option:
.. rst-class:: classref-method
|void| **menu_option**\ (\ option\: :ref:`int<class_int>`\ ) :ref:`🔗<class_LineEdit_method_menu_option>`
Выполняет заданное действие, определенное в перечислении :ref:`MenuItems<enum_LineEdit_MenuItems>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_select:
.. rst-class:: classref-method
|void| **select**\ (\ from\: :ref:`int<class_int>` = 0, to\: :ref:`int<class_int>` = -1\ ) :ref:`🔗<class_LineEdit_method_select>`
Выбирает символы внутри **LineEdit** между ``from`` и ``to``. По умолчанию ``from`` находится в начале, а ``to`` — в конце.
.. tabs::
.. code-tab:: gdscript
text = "Welcome"
select() # Выберите "Welcome".
select(4) # Выберите "ome".
select(2, 5) # Выберите "lco".
.. code-tab:: csharp
Text = "Welcome";
Select(); // Выберите "Welcome".
Select(4); // Выберите "ome".
Select(2, 5); // Выберите "lco".
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_select_all:
.. rst-class:: classref-method
|void| **select_all**\ (\ ) :ref:`🔗<class_LineEdit_method_select_all>`
Выделяет всю :ref:`String<class_String>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_unedit:
.. rst-class:: classref-method
|void| **unedit**\ (\ ) :ref:`🔗<class_LineEdit_method_unedit>`
Позволяет выйти из режима редактирования, сохраняя фокус.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Описания свойств темы
------------------------------------------
.. _class_LineEdit_theme_color_caret_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **caret_color** = ``Color(0.95, 0.95, 0.95, 1)`` :ref:`🔗<class_LineEdit_theme_color_caret_color>`
Цвет каретки (текстового курсора) **LineEdit**. Его можно установить на полностью прозрачный цвет, чтобы полностью скрыть каретку.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_clear_button_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **clear_button_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗<class_LineEdit_theme_color_clear_button_color>`
Цвет, используемый в качестве оттенка по умолчанию для кнопки очистки.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_clear_button_color_pressed:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **clear_button_color_pressed** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_LineEdit_theme_color_clear_button_color_pressed>`
Цвет, используемый для кнопки очистки при ее нажатии.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_font_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗<class_LineEdit_theme_color_font_color>`
Цвет шрифта по умолч.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_font_outline_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_outline_color** = ``Color(0, 0, 0, 1)`` :ref:`🔗<class_LineEdit_theme_color_font_outline_color>`
Оттенок контура текста **LineEdit**.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_font_placeholder_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_placeholder_color** = ``Color(0.875, 0.875, 0.875, 0.6)`` :ref:`🔗<class_LineEdit_theme_color_font_placeholder_color>`
Цвет шрифта для :ref:`placeholder_text<class_LineEdit_property_placeholder_text>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_font_selected_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_selected_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_LineEdit_theme_color_font_selected_color>`
Цвет шрифта для выделенного текста (внутри прямоугольника выделения).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_font_uneditable_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_uneditable_color** = ``Color(0.875, 0.875, 0.875, 0.5)`` :ref:`🔗<class_LineEdit_theme_color_font_uneditable_color>`
Цвет шрифта при редактировании отключен.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_selection_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **selection_color** = ``Color(0.5, 0.5, 0.5, 1)`` :ref:`🔗<class_LineEdit_theme_color_selection_color>`
Цвет прямоугольника выделения.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_constant_caret_width:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **caret_width** = ``1`` :ref:`🔗<class_LineEdit_theme_constant_caret_width>`
Ширина каретки в пикселях. Большие значения можно использовать для улучшения доступности, обеспечивая легкую видимость каретки или для обеспечения согласованности с большим размером шрифта.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_constant_minimum_character_width:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **minimum_character_width** = ``4`` :ref:`🔗<class_LineEdit_theme_constant_minimum_character_width>`
Минимальное горизонтальное пространство для текста (не считая кнопку очистки и полей содержимого). Это значение измеряется в количестве символов «M» (т.е. это количество символов «M» может быть отображено без прокрутки).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_constant_outline_size:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **outline_size** = ``0`` :ref:`🔗<class_LineEdit_theme_constant_outline_size>`
Размер контура текста.
\ **Примечание:** При использовании шрифта с включенным :ref:`FontFile.multichannel_signed_distance_field<class_FontFile_property_multichannel_signed_distance_field>` его :ref:`FontFile.msdf_pixel_range<class_FontFile_property_msdf_pixel_range>` должен быть установлен как минимум в *дважды* значения :ref:`outline_size<class_LineEdit_theme_constant_outline_size>`, чтобы контур выглядел правильно. В противном случае контур может оказаться обрезанным раньше, чем предполагалось.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_font_font:
.. rst-class:: classref-themeproperty
:ref:`Font<class_Font>` **font** :ref:`🔗<class_LineEdit_theme_font_font>`
Шрифт, используемый в тексте.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_font_size_font_size:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **font_size** :ref:`🔗<class_LineEdit_theme_font_size_font_size>`
Размер шрифта текста **LineEdit**.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_icon_clear:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **clear** :ref:`🔗<class_LineEdit_theme_icon_clear>`
Текстура для кнопки очистки. Смотрите :ref:`clear_button_enabled<class_LineEdit_property_clear_button_enabled>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_style_focus:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **focus** :ref:`🔗<class_LineEdit_theme_style_focus>`
Фон используется, когда **LineEdit** имеет фокус GUI. ``Фокус [theme_item`` :ref:`StyleBox<class_StyleBox>` отображается *над* базовым :ref:`StyleBox<class_StyleBox>`, поэтому следует использовать частично прозрачный :ref:`StyleBox<class_StyleBox>`, чтобы базовый :ref:`StyleBox<class_StyleBox>` оставался видимым. :ref:`StyleBox<class_StyleBox>`, представляющий контур или подчеркивание, хорошо подходит для этой цели. Чтобы отключить визуальный эффект фокуса, назначьте ресурс :ref:`StyleBoxEmpty<class_StyleBoxEmpty>`. Обратите внимание, что отключение визуального эффекта фокуса навредит удобству использования навигации с помощью клавиатуры/контроллера, поэтому это не рекомендуется по соображениям доступности.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_style_normal:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **normal** :ref:`🔗<class_LineEdit_theme_style_normal>`
Фон по умолчанию для **LineEdit**.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_style_read_only:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **read_only** :ref:`🔗<class_LineEdit_theme_style_read_only>`
Фон используется, когда **LineEdit** находится в режиме только для чтения (:ref:`editable<class_LineEdit_property_editable>` имеет значение ``false``).
.. |virtual| replace:: :abbr:`virtual (Этот метод обычно должен быть переопределен пользователем, чтобы иметь какой-либо эффект.)`
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
.. |const| replace:: :abbr:`const (Этот метод не имеет побочных эффектов. Он не изменяет ни одну из переменных-членов экземпляра.)`
.. |vararg| replace:: :abbr:`vararg (Этот метод принимает любое количество аргументов после описанных здесь.)`
.. |constructor| replace:: :abbr:`constructor (Этот метод используется для создания типа.)`
.. |static| replace:: :abbr:`static (Этот метод не нуждается в вызове экземпляра, поэтому его можно вызвать напрямую, используя имя класса.)`
.. |operator| replace:: :abbr:`operator (Этот метод описывает допустимый оператор для использования с этим типом в качестве левого операнда.)`
.. |bitfield| replace:: :abbr:`BitField (Это значение является целым числом, составленным как битовая маска следующих флагов.)`
.. |void| replace:: :abbr:`void (Нет возвращаемого значения.)`
Reference in New Issue View Git Blame Copy Permalink