Files
godot-docs-l10n/classes/uk/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
103 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 alt:
- Щоб ввести кодові точки 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:`Стрілка вгору`/:kbd:`Стрілка вниз`: Перемістити каретку на початок/кінець рядка
У 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 + Стрілка вліво`: Те саме, що :kbd:`Home`, перемістити каретку на початок рядка
- :kbd:`Cmd + Стрілка вправо`: Те саме, що й :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``
Вставте текст буфера над вибраним текстом (або на позиції догляду).
Недруковані символи втечу автоматично скомпедуються з клавіатури OS через :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``
Вставки м'якого фена (ШІ) характеру.
.. _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>` enum.
.. 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``
Віртуальний номер клавіатури, корисний для входу PIN.
.. _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``
Віртуальна клавіатура для введення пароля. На більшості платформ, це слід відключити автозакінчення і автоматизацію.
\ **Примітка:** Це не підтримується на Веб-сайті. Замість цього, такі породи ідентично :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``, клавіша Backspace видаляє цілий складений символ, наприклад ❤️‍🩹, а не частину складеного символу.
.. 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``, рідна віртуальна клавіатура відображається під час подій focus на платформах, які її підтримують.
.. 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>`
Стирає елементи **LineEdit** :ref:`text<class_LineEdit_property_text>`.
.. 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();
// Видалити всі елементи після "Redo".
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``, якщо користувач має текст у `Input Method Editor <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``, якщо доступна акція "redo".
.. 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``, якщо доступна акція "undo".
.. 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().видимі `` для поліпшення продуктивності (наприклад, створення меню уникнути).
.. 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>` enum.
.. 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 = "Ласкаво просимо"
select() # Вибере "Ласкаво просимо".
select(4) # Вибере "ome".
select(2, 5) # Вибере "lco".
.. code-tab:: csharp
Text = "Ласкаво просимо";
select(); // Вибере "Ласкаво просимо".
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. :ref:`focus<class_LineEdit_theme_style_focus>` :ref:`StyleBox<class_StyleBox>` відображається *over* бази :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 (Значення не повертається.)`