:github_url: hide .. meta:: :keywords: text, input .. _class_LineEdit: LineEdit ======== **Наследует:** :ref:`Control` **<** :ref:`CanvasItem` **<** :ref:`Node` **<** :ref:`Object` Поле ввода для однострочного текста. .. rst-class:: classref-introduction-group Описание ---------------- **LineEdit** предоставляет поле ввода для редактирования одной строки текста. - Когда элемент управления **LineEdit** сфокусирован с помощью клавиш со стрелками на клавиатуре, он только получит фокус, но не перейдет в режим редактирования. - Чтобы войти в режим редактирования, щелкните элемент управления мышью, см. также :ref:`keep_editing_on_text_submit`. - Чтобы выйти из режима редактирования, нажмите ``ui_text_submit`` или ``ui_cancel`` (по умолчанию :kbd:`Escape`) действия. - Проверьте :ref:`edit()`, :ref:`unedit()`, :ref:`is_editing()` и :ref:`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()` по-прежнему переходит в режим редактирования (для совместимости). \ **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`. .. rst-class:: classref-reftable-group Свойства ---------------- .. table:: :widths: auto +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`HorizontalAlignment` | :ref:`alignment` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`backspace_deletes_composite_character_enabled` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`caret_blink` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`caret_blink_interval` | ``0.65`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`caret_column` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`caret_force_displayed` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`caret_mid_grapheme` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`clear_button_enabled` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`context_menu_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`deselect_on_focus_loss_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`drag_and_drop_selection_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`draw_control_chars` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`editable` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`emoji_menu_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`expand_to_text_length` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`flat` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`FocusMode` | focus_mode | ``2`` (overrides :ref:`Control`) | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`ExpandMode` | :ref:`icon_expand_mode` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`keep_editing_on_text_submit` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`language` | ``""`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`max_length` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`middle_mouse_paste_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`CursorShape` | mouse_default_cursor_shape | ``1`` (overrides :ref:`Control`) | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`placeholder_text` | ``""`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`Texture2D` | :ref:`right_icon` | | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`right_icon_scale` | ``1.0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`secret` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`secret_character` | ``"•"`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`select_all_on_focus` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`selecting_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`shortcut_keys_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`StructuredTextParser` | :ref:`structured_text_bidi_override` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`Array` | :ref:`structured_text_bidi_override_options` | ``[]`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`text` | ``""`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`TextDirection` | :ref:`text_direction` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`virtual_keyboard_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`virtual_keyboard_show_on_focus` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`VirtualKeyboardType` | :ref:`virtual_keyboard_type` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group Методы ------------ .. table:: :widths: auto +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`apply_ime`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`cancel_ime`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`clear`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`delete_char_at_caret`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`delete_text`\ (\ from_column\: :ref:`int`, to_column\: :ref:`int`\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`deselect`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`edit`\ (\ hide_focus\: :ref:`bool` = false\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PopupMenu` | :ref:`get_menu`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_next_composite_character_column`\ (\ column\: :ref:`int`\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_previous_composite_character_column`\ (\ column\: :ref:`int`\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_scroll_offset`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_selected_text`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_selection_from_column`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_selection_to_column`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_ime_text`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_redo`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_selection`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_undo`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`insert_text_at_caret`\ (\ text\: :ref:`String`\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_editing`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_menu_visible`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`menu_option`\ (\ option\: :ref:`int`\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`select`\ (\ from\: :ref:`int` = 0, to\: :ref:`int` = -1\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`select_all`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`unedit`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group Свойства темы -------------------------- .. table:: :widths: auto +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`caret_color` | ``Color(0.95, 0.95, 0.95, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`clear_button_color` | ``Color(0.875, 0.875, 0.875, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`clear_button_color_pressed` | ``Color(1, 1, 1, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_color` | ``Color(0.875, 0.875, 0.875, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_outline_color` | ``Color(0, 0, 0, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_placeholder_color` | ``Color(0.875, 0.875, 0.875, 0.6)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_selected_color` | ``Color(1, 1, 1, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_uneditable_color` | ``Color(0.875, 0.875, 0.875, 0.5)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`selection_color` | ``Color(0.5, 0.5, 0.5, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`caret_width` | ``1`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`minimum_character_width` | ``4`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`outline_size` | ``0`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Font` | :ref:`font` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`font_size` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Texture2D` | :ref:`clear` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`focus` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`normal` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`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`\ ) :ref:`🔗` Вызывается, когда **LineEdit** переключается в режим редактирования или выходит из него. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_signal_text_change_rejected: .. rst-class:: classref-signal **text_change_rejected**\ (\ rejected_substring\: :ref:`String`\ ) :ref:`🔗` Вызывается при добавлении текста, который выходит за пределы :ref:`max_length`. Добавленный текст усекается, чтобы соответствовать :ref:`max_length`, а часть, которая не помещается, передается как аргумент\ ``rejected_substring``. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_signal_text_changed: .. rst-class:: classref-signal **text_changed**\ (\ new_text\: :ref:`String`\ ) :ref:`🔗` Выдается при изменении текста. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_signal_text_submitted: .. rst-class:: classref-signal **text_submitted**\ (\ new_text\: :ref:`String`\ ) :ref:`🔗` Вызывается, когда пользователь нажимает действие ``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:`🔗` .. _class_LineEdit_constant_MENU_CUT: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_CUT** = ``0`` Вырезает (копирует и очищает) выделенный текст. .. _class_LineEdit_constant_MENU_COPY: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_COPY** = ``1`` Копирует выделенный текст. .. _class_LineEdit_constant_MENU_PASTE: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_PASTE** = ``2`` Вставляет текст буфера обмена поверх выделенного текста (или в позицию курсора). Непечатаемые экранированные символы автоматически удаляются из буфера обмена ОС с помощью :ref:`String.strip_escapes()`. .. _class_LineEdit_constant_MENU_CLEAR: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_CLEAR** = ``3`` Стирает весь текст **LineEdit**. .. _class_LineEdit_constant_MENU_SELECT_ALL: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_SELECT_ALL** = ``4`` Выделяет весь текст **LineEdit**. .. _class_LineEdit_constant_MENU_UNDO: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_UNDO** = ``5`` Отменяет предыдущее действие. .. _class_LineEdit_constant_MENU_REDO: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_REDO** = ``6`` Отменить последнее отмененное действие. .. _class_LineEdit_constant_MENU_SUBMENU_TEXT_DIR: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_SUBMENU_TEXT_DIR** = ``7`` Идентификатор подменю «Направление написания текста». .. _class_LineEdit_constant_MENU_DIR_INHERITED: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_DIR_INHERITED** = ``8`` Устанавливает унаследованное направление текста. .. _class_LineEdit_constant_MENU_DIR_AUTO: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_DIR_AUTO** = ``9`` Устанавливает автоматическое направление текста. .. _class_LineEdit_constant_MENU_DIR_LTR: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_DIR_LTR** = ``10`` Устанавливает направление текста слева направо. .. _class_LineEdit_constant_MENU_DIR_RTL: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_DIR_RTL** = ``11`` Устанавливает направление текста справа налево. .. _class_LineEdit_constant_MENU_DISPLAY_UCC: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_DISPLAY_UCC** = ``12`` Переключает отображение управляющего символа. .. _class_LineEdit_constant_MENU_SUBMENU_INSERT_UCC: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_SUBMENU_INSERT_UCC** = ``13`` Идентификатор подменю «Вставить управляющий символ». .. _class_LineEdit_constant_MENU_INSERT_LRM: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_LRM** = ``14`` Вставляет символ знака слева направо (LRM). .. _class_LineEdit_constant_MENU_INSERT_RLM: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_RLM** = ``15`` Вставляет символ с письмом справа налево (RLM). .. _class_LineEdit_constant_MENU_INSERT_LRE: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_LRE** = ``16`` Вставляет начало символа вставки слева направо (LRE). .. _class_LineEdit_constant_MENU_INSERT_RLE: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_RLE** = ``17`` Вставляет начало символа вставки справа налево (RLE). .. _class_LineEdit_constant_MENU_INSERT_LRO: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_LRO** = ``18`` Вставляет начало символа переопределения слева направо (LRO). .. _class_LineEdit_constant_MENU_INSERT_RLO: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_RLO** = ``19`` Вставляет начало символа переопределения справа налево (RLO). .. _class_LineEdit_constant_MENU_INSERT_PDF: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_PDF** = ``20`` Вставляет символ форматирования направления поп-арта (PDF). .. _class_LineEdit_constant_MENU_INSERT_ALM: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_ALM** = ``21`` Вставляет символ арабской буквы (ALM). .. _class_LineEdit_constant_MENU_INSERT_LRI: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_LRI** = ``22`` Вставляет изолирующий символ слева направо (LRI). .. _class_LineEdit_constant_MENU_INSERT_RLI: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_RLI** = ``23`` Вставляет изолирующий символ справа налево (RLI). .. _class_LineEdit_constant_MENU_INSERT_FSI: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_FSI** = ``24`` Вставляет первый сильный изолятный (FSI) символ. .. _class_LineEdit_constant_MENU_INSERT_PDI: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_PDI** = ``25`` Вставляет символ изоляции направления поп-музыки (PDI). .. _class_LineEdit_constant_MENU_INSERT_ZWJ: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_ZWJ** = ``26`` Вставляет символ объединения нулевой ширины (ZWJ). .. _class_LineEdit_constant_MENU_INSERT_ZWNJ: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_ZWNJ** = ``27`` Вставляет символ нулевой ширины, не являющийся объединяющим (ZWNJ). .. _class_LineEdit_constant_MENU_INSERT_WJ: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_WJ** = ``28`` Вставляет символ объединения слов (WJ). .. _class_LineEdit_constant_MENU_INSERT_SHY: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_SHY** = ``29`` Вставляет символ мягкого дефиса (SHY). .. _class_LineEdit_constant_MENU_EMOJI_AND_SYMBOL: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_EMOJI_AND_SYMBOL** = ``30`` Открывает системный выбор эмодзи и символов. .. _class_LineEdit_constant_MENU_MAX: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_MAX** = ``31`` Представляет размер перечисления :ref:`MenuItems`. .. rst-class:: classref-item-separator ---- .. _enum_LineEdit_VirtualKeyboardType: .. rst-class:: classref-enumeration enum **VirtualKeyboardType**: :ref:`🔗` .. _class_LineEdit_constant_KEYBOARD_TYPE_DEFAULT: .. rst-class:: classref-enumeration-constant :ref:`VirtualKeyboardType` **KEYBOARD_TYPE_DEFAULT** = ``0`` Текстовая виртуальная клавиатура по умолчанию. .. _class_LineEdit_constant_KEYBOARD_TYPE_MULTILINE: .. rst-class:: classref-enumeration-constant :ref:`VirtualKeyboardType` **KEYBOARD_TYPE_MULTILINE** = ``1`` Многострочная виртуальная клавиатура. .. _class_LineEdit_constant_KEYBOARD_TYPE_NUMBER: .. rst-class:: classref-enumeration-constant :ref:`VirtualKeyboardType` **KEYBOARD_TYPE_NUMBER** = ``2`` Виртуальная цифровая клавиатура, полезная для ввода ПИН-кода. .. _class_LineEdit_constant_KEYBOARD_TYPE_NUMBER_DECIMAL: .. rst-class:: classref-enumeration-constant :ref:`VirtualKeyboardType` **KEYBOARD_TYPE_NUMBER_DECIMAL** = ``3`` Виртуальная цифровая клавиатура, полезная для ввода дробных чисел. .. _class_LineEdit_constant_KEYBOARD_TYPE_PHONE: .. rst-class:: classref-enumeration-constant :ref:`VirtualKeyboardType` **KEYBOARD_TYPE_PHONE** = ``4`` Виртуальная клавиатура для набора номера телефона. .. _class_LineEdit_constant_KEYBOARD_TYPE_EMAIL_ADDRESS: .. rst-class:: classref-enumeration-constant :ref:`VirtualKeyboardType` **KEYBOARD_TYPE_EMAIL_ADDRESS** = ``5`` Виртуальная клавиатура с дополнительными клавишами для облегчения ввода адресов электронной почты. .. _class_LineEdit_constant_KEYBOARD_TYPE_PASSWORD: .. rst-class:: classref-enumeration-constant :ref:`VirtualKeyboardType` **KEYBOARD_TYPE_PASSWORD** = ``6`` Виртуальная клавиатура для ввода пароля. На большинстве платформ это должно отключить автозаполнение и автоматическую капитализацию. \ **Примечание:** Это не поддерживается в Web. Вместо этого это ведет себя идентично :ref:`KEYBOARD_TYPE_DEFAULT`. .. _class_LineEdit_constant_KEYBOARD_TYPE_URL: .. rst-class:: classref-enumeration-constant :ref:`VirtualKeyboardType` **KEYBOARD_TYPE_URL** = ``7`` Виртуальная клавиатура с дополнительными клавишами для облегчения ввода URL-адресов. .. rst-class:: classref-item-separator ---- .. _enum_LineEdit_ExpandMode: .. rst-class:: classref-enumeration enum **ExpandMode**: :ref:`🔗` .. _class_LineEdit_constant_EXPAND_MODE_ORIGINAL_SIZE: .. rst-class:: classref-enumeration-constant :ref:`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` **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` **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` **alignment** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_horizontal_alignment**\ (\ value\: :ref:`HorizontalAlignment`\ ) - :ref:`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` **backspace_deletes_composite_character_enabled** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_backspace_deletes_composite_character_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_backspace_deletes_composite_character_enabled**\ (\ ) Если ``true`` и :ref:`caret_mid_grapheme` в значении ``false``, Возврат удаляет весь составной символ, такой как ❤️‍🩹, вместо удаления части составного символа. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_caret_blink: .. rst-class:: classref-property :ref:`bool` **caret_blink** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_caret_blink_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_caret_blink_enabled**\ (\ ) Если ``true``, курсор мигает. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_caret_blink_interval: .. rst-class:: classref-property :ref:`float` **caret_blink_interval** = ``0.65`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_caret_blink_interval**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_caret_blink_interval**\ (\ ) Интервал мигания курсора (в секундах). .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_caret_column: .. rst-class:: classref-property :ref:`int` **caret_column** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_caret_column**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_caret_column**\ (\ ) Положение столбца курсора внутри **LineEdit**. Если установлено, текст может прокручиваться, чтобы вместить его. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_caret_force_displayed: .. rst-class:: classref-property :ref:`bool` **caret_force_displayed** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_caret_force_displayed**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_caret_force_displayed**\ (\ ) Если ``true``, **LineEdit** всегда будет отображать курсор, даже если редактирование не выполняется или фокус потерян. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_caret_mid_grapheme: .. rst-class:: classref-property :ref:`bool` **caret_mid_grapheme** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_caret_mid_grapheme_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **clear_button_enabled** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_clear_button_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_clear_button_enabled**\ (\ ) Если ``true``, **LineEdit** отобразит кнопку очистки, если :ref:`text` не пуст, что можно использовать для быстрой очистки текста. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_context_menu_enabled: .. rst-class:: classref-property :ref:`bool` **context_menu_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_context_menu_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **deselect_on_focus_loss_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_deselect_on_focus_loss_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **drag_and_drop_selection_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_drag_and_drop_selection_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **draw_control_chars** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_draw_control_chars**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **get_draw_control_chars**\ (\ ) Если ``true``, отображаются управляющие символы. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_editable: .. rst-class:: classref-property :ref:`bool` **editable** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_editable**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_editable**\ (\ ) Если ``false``, существующий текст не может быть изменен и новый текст не может быть добавлен. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_emoji_menu_enabled: .. rst-class:: classref-property :ref:`bool` **emoji_menu_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_emoji_menu_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_emoji_menu_enabled**\ (\ ) Если ``true``, меню «Эмодзи и символы» включено. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_expand_to_text_length: .. rst-class:: classref-property :ref:`bool` **expand_to_text_length** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_expand_to_text_length_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_expand_to_text_length_enabled**\ (\ ) Если ``true``, ширина **LineEdit** увеличится и останется длиннее, чем :ref:`text`. Он **не** сожмется, если :ref:`text` будет сокращен. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_flat: .. rst-class:: classref-property :ref:`bool` **flat** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_flat**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_flat**\ (\ ) Если ``true``, **LineEdit** не отображает оформление. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_icon_expand_mode: .. rst-class:: classref-property :ref:`ExpandMode` **icon_expand_mode** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_icon_expand_mode**\ (\ value\: :ref:`ExpandMode`\ ) - :ref:`ExpandMode` **get_icon_expand_mode**\ (\ ) Define the scaling behavior of the :ref:`right_icon`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_keep_editing_on_text_submit: .. rst-class:: classref-property :ref:`bool` **keep_editing_on_text_submit** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_keep_editing_on_text_submit**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **language** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`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` **max_length** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_max_length**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_max_length**\ (\ ) Максимальное количество символов, которое можно ввести в **LineEdit**. Если ``0``, ограничений нет. Если задано ограничение, символы, превышающие :ref:`max_length`, обрезаются. Это происходит как с существующим содержимым :ref:`text` при установке максимальной длины, так и с новым текстом, вставленным в **LineEdit**, включая вставку. Если какой-либо введённый текст обрезается, выдаётся сигнал :ref:`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` **middle_mouse_paste_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_middle_mouse_paste_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_middle_mouse_paste_enabled**\ (\ ) Если ``false``, использование средней кнопки мыши для вставки буфера обмена будет отключено. \ **Примечание:** Этот метод реализован только в Linux. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_placeholder_text: .. rst-class:: classref-property :ref:`String` **placeholder_text** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_placeholder**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_placeholder**\ (\ ) Текст, отображаемый, когда **LineEdit** пуст. Это **не** значение по умолчанию для **LineEdit** (см. :ref:`text`). .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_right_icon: .. rst-class:: classref-property :ref:`Texture2D` **right_icon** :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_right_icon**\ (\ value\: :ref:`Texture2D`\ ) - :ref:`Texture2D` **get_right_icon**\ (\ ) Устанавливает значок, который будет отображаться в правом конце **LineEdit**, если нет :ref:`text`, или всегда, если :ref:`clear_button_enabled` установлен в ``false``. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_right_icon_scale: .. rst-class:: classref-property :ref:`float` **right_icon_scale** = ``1.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_right_icon_scale**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_right_icon_scale**\ (\ ) Scale ratio of the icon when :ref:`icon_expand_mode` is set to :ref:`EXPAND_MODE_FIT_TO_LINE_EDIT`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_secret: .. rst-class:: classref-property :ref:`bool` **secret** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_secret**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_secret**\ (\ ) Если ``true``, каждый символ заменяется секретным символом (см. :ref:`secret_character`). .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_secret_character: .. rst-class:: classref-property :ref:`String` **secret_character** = ``"•"`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_secret_character**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_secret_character**\ (\ ) Символ, используемый для маскировки секретного ввода. В качестве секретного символа можно использовать только один символ. Если он длиннее одного символа, будет использоваться только первый. Если он пустой, вместо него будет использоваться пробел. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_select_all_on_focus: .. rst-class:: classref-property :ref:`bool` **select_all_on_focus** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_select_all_on_focus**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_select_all_on_focus**\ (\ ) Если ``true``, **LineEdit** выделит весь текст, когда получит фокус. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_selecting_enabled: .. rst-class:: classref-property :ref:`bool` **selecting_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_selecting_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_selecting_enabled**\ (\ ) Если ``false``, невозможно выделить текст с помощью мыши или клавиатуры. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_shortcut_keys_enabled: .. rst-class:: classref-property :ref:`bool` **shortcut_keys_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_shortcut_keys_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_shortcut_keys_enabled**\ (\ ) Если ``true``, сочетания клавиш для пунктов контекстного меню включены, даже если контекстное меню отключено. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_structured_text_bidi_override: .. rst-class:: classref-property :ref:`StructuredTextParser` **structured_text_bidi_override** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_structured_text_bidi_override**\ (\ value\: :ref:`StructuredTextParser`\ ) - :ref:`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` **structured_text_bidi_override_options** = ``[]`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_structured_text_bidi_override_options**\ (\ value\: :ref:`Array`\ ) - :ref:`Array` **get_structured_text_bidi_override_options**\ (\ ) Установите дополнительные параметры для переопределения BiDi. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_text: .. rst-class:: classref-property :ref:`String` **text** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_text**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_text**\ (\ ) Строковое значение **LineEdit**. \ **Примечание:** Изменение текста с использованием этого свойства не будет генерировать сигнал :ref:`text_changed`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_text_direction: .. rst-class:: classref-property :ref:`TextDirection` **text_direction** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_text_direction**\ (\ value\: :ref:`TextDirection`\ ) - :ref:`TextDirection` **get_text_direction**\ (\ ) Направление написания базового текста. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_virtual_keyboard_enabled: .. rst-class:: classref-property :ref:`bool` **virtual_keyboard_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_virtual_keyboard_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **virtual_keyboard_show_on_focus** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_virtual_keyboard_show_on_focus**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **virtual_keyboard_type** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_virtual_keyboard_type**\ (\ value\: :ref:`VirtualKeyboardType`\ ) - :ref:`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:`🔗` Применяет текст из `редактора метода ввода `__ (IME) и закрывает IME, если он открыт. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_cancel_ime: .. rst-class:: classref-method |void| **cancel_ime**\ (\ ) :ref:`🔗` Закрывает `Редактор метода ввода `__ (IME), если он открыт. Любой текст в IME будет потерян. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_clear: .. rst-class:: classref-method |void| **clear**\ (\ ) :ref:`🔗` Удаляет :ref:`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:`🔗` Удаляет один символ в текущей позиции курсора (эквивалентно нажатию :kbd:`Delete`). .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_delete_text: .. rst-class:: classref-method |void| **delete_text**\ (\ from_column\: :ref:`int`, to_column\: :ref:`int`\ ) :ref:`🔗` Удаляет часть :ref:`text`, начиная с позиции ``from_column`` до ``to_column``. Оба параметра должны быть в пределах длины текста. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_deselect: .. rst-class:: classref-method |void| **deselect**\ (\ ) :ref:`🔗` Очищает текущий выбор. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_edit: .. rst-class:: classref-method |void| **edit**\ (\ hide_focus\: :ref:`bool` = false\ ) :ref:`🔗` 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()`). See also :ref:`keep_editing_on_text_submit`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_get_menu: .. rst-class:: classref-method :ref:`PopupMenu` **get_menu**\ (\ ) |const| :ref:`🔗` Возвращает :ref:`PopupMenu` этого **LineEdit**. По умолчанию это меню отображается при щелчке правой кнопкой мыши по **LineEdit**. Вы можете добавлять пользовательские пункты меню или удалять стандартные. Убедитесь, что ваши идентификаторы не конфликтуют со стандартными (см. :ref:`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`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_get_next_composite_character_column: .. rst-class:: classref-method :ref:`int` **get_next_composite_character_column**\ (\ column\: :ref:`int`\ ) |const| :ref:`🔗` Возвращает правильный столбец в конце составного символа, такого как ❤️‍🩹 (исправление сердца; 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` **get_previous_composite_character_column**\ (\ column\: :ref:`int`\ ) |const| :ref:`🔗` Возвращает правильный столбец в начале композитного символа, такого как ❤️‍🩹 (исправление сердца; 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` **get_scroll_offset**\ (\ ) |const| :ref:`🔗` Возвращает смещение прокрутки из-за :ref:`caret_column` в виде количества символов. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_get_selected_text: .. rst-class:: classref-method :ref:`String` **get_selected_text**\ (\ ) :ref:`🔗` Возвращает текст внутри выделения. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_get_selection_from_column: .. rst-class:: classref-method :ref:`int` **get_selection_from_column**\ (\ ) |const| :ref:`🔗` Возвращает начальный столбец выбора. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_get_selection_to_column: .. rst-class:: classref-method :ref:`int` **get_selection_to_column**\ (\ ) |const| :ref:`🔗` Возвращает конечный столбец выбора. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_has_ime_text: .. rst-class:: classref-method :ref:`bool` **has_ime_text**\ (\ ) |const| :ref:`🔗` Возвращает ``true``, если у пользователя есть текст в `редакторе метода ввода `__ (IME). .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_has_redo: .. rst-class:: classref-method :ref:`bool` **has_redo**\ (\ ) |const| :ref:`🔗` Возвращает ``true``, если доступно действие «повторить». .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_has_selection: .. rst-class:: classref-method :ref:`bool` **has_selection**\ (\ ) |const| :ref:`🔗` Возвращает ``true``, если пользователь выбрал текст. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_has_undo: .. rst-class:: classref-method :ref:`bool` **has_undo**\ (\ ) |const| :ref:`🔗` Возвращает ``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`\ ) :ref:`🔗` Вставляет ``text`` в каретку. Если полученное значение длиннее, чем :ref:`max_length`, ничего не происходит. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_is_editing: .. rst-class:: classref-method :ref:`bool` **is_editing**\ (\ ) |const| :ref:`🔗` Возвращает, редактируется ли **LineEdit**. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_is_menu_visible: .. rst-class:: classref-method :ref:`bool` **is_menu_visible**\ (\ ) |const| :ref:`🔗` Возвращает, видимо ли меню. Используйте это вместо ``get_menu().visible`` для повышения производительности (чтобы избежать создания меню). .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_menu_option: .. rst-class:: classref-method |void| **menu_option**\ (\ option\: :ref:`int`\ ) :ref:`🔗` Выполняет заданное действие, определенное в перечислении :ref:`MenuItems`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_select: .. rst-class:: classref-method |void| **select**\ (\ from\: :ref:`int` = 0, to\: :ref:`int` = -1\ ) :ref:`🔗` Выбирает символы внутри **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:`🔗` Выделяет всю :ref:`String`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_unedit: .. rst-class:: classref-method |void| **unedit**\ (\ ) :ref:`🔗` Позволяет выйти из режима редактирования, сохраняя фокус. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Описания свойств темы ------------------------------------------ .. _class_LineEdit_theme_color_caret_color: .. rst-class:: classref-themeproperty :ref:`Color` **caret_color** = ``Color(0.95, 0.95, 0.95, 1)`` :ref:`🔗` Цвет каретки (текстового курсора) **LineEdit**. Его можно установить на полностью прозрачный цвет, чтобы полностью скрыть каретку. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_color_clear_button_color: .. rst-class:: classref-themeproperty :ref:`Color` **clear_button_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗` Цвет, используемый в качестве оттенка по умолчанию для кнопки очистки. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_color_clear_button_color_pressed: .. rst-class:: classref-themeproperty :ref:`Color` **clear_button_color_pressed** = ``Color(1, 1, 1, 1)`` :ref:`🔗` Цвет, используемый для кнопки очистки при ее нажатии. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_color_font_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗` Цвет шрифта по умолч. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_color_font_outline_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_outline_color** = ``Color(0, 0, 0, 1)`` :ref:`🔗` Оттенок контура текста **LineEdit**. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_color_font_placeholder_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_placeholder_color** = ``Color(0.875, 0.875, 0.875, 0.6)`` :ref:`🔗` Цвет шрифта для :ref:`placeholder_text`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_color_font_selected_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_selected_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` Цвет шрифта для выделенного текста (внутри прямоугольника выделения). .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_color_font_uneditable_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_uneditable_color** = ``Color(0.875, 0.875, 0.875, 0.5)`` :ref:`🔗` Цвет шрифта при редактировании отключен. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_color_selection_color: .. rst-class:: classref-themeproperty :ref:`Color` **selection_color** = ``Color(0.5, 0.5, 0.5, 1)`` :ref:`🔗` Цвет прямоугольника выделения. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_constant_caret_width: .. rst-class:: classref-themeproperty :ref:`int` **caret_width** = ``1`` :ref:`🔗` Ширина каретки в пикселях. Большие значения можно использовать для улучшения доступности, обеспечивая легкую видимость каретки или для обеспечения согласованности с большим размером шрифта. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_constant_minimum_character_width: .. rst-class:: classref-themeproperty :ref:`int` **minimum_character_width** = ``4`` :ref:`🔗` Минимальное горизонтальное пространство для текста (не считая кнопку очистки и полей содержимого). Это значение измеряется в количестве символов «M» (т.е. это количество символов «M» может быть отображено без прокрутки). .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_constant_outline_size: .. rst-class:: classref-themeproperty :ref:`int` **outline_size** = ``0`` :ref:`🔗` Размер контура текста. \ **Примечание:** При использовании шрифта с включенным :ref:`FontFile.multichannel_signed_distance_field` его :ref:`FontFile.msdf_pixel_range` должен быть установлен как минимум в *дважды* значения :ref:`outline_size`, чтобы контур выглядел правильно. В противном случае контур может оказаться обрезанным раньше, чем предполагалось. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_font_font: .. rst-class:: classref-themeproperty :ref:`Font` **font** :ref:`🔗` Шрифт, используемый в тексте. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_font_size_font_size: .. rst-class:: classref-themeproperty :ref:`int` **font_size** :ref:`🔗` Размер шрифта текста **LineEdit**. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_icon_clear: .. rst-class:: classref-themeproperty :ref:`Texture2D` **clear** :ref:`🔗` Текстура для кнопки очистки. Смотрите :ref:`clear_button_enabled`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_style_focus: .. rst-class:: classref-themeproperty :ref:`StyleBox` **focus** :ref:`🔗` Фон используется, когда **LineEdit** имеет фокус GUI. ``Фокус [theme_item`` :ref:`StyleBox` отображается *над* базовым :ref:`StyleBox`, поэтому следует использовать частично прозрачный :ref:`StyleBox`, чтобы базовый :ref:`StyleBox` оставался видимым. :ref:`StyleBox`, представляющий контур или подчеркивание, хорошо подходит для этой цели. Чтобы отключить визуальный эффект фокуса, назначьте ресурс :ref:`StyleBoxEmpty`. Обратите внимание, что отключение визуального эффекта фокуса навредит удобству использования навигации с помощью клавиатуры/контроллера, поэтому это не рекомендуется по соображениям доступности. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_style_normal: .. rst-class:: classref-themeproperty :ref:`StyleBox` **normal** :ref:`🔗` Фон по умолчанию для **LineEdit**. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_style_read_only: .. rst-class:: classref-themeproperty :ref:`StyleBox` **read_only** :ref:`🔗` Фон используется, когда **LineEdit** находится в режиме только для чтения (:ref:`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 (Нет возвращаемого значения.)`