Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

LineEdit

Успадковує: Control < CanvasItem < Node < Object

Вхідне поле для однолінійного тексту.

Опис

LineEdit надає поле введення для редагування одного рядка тексту.

  • Коли елемент керування LineEdit сфокусовано за допомогою клавіш зі стрілками клавіатури, він лише отримає фокус і не перейде в режим редагування.

  • Щоб увійти в режим редагування, клацніть на елементі керування мишею, див. також keep_editing_on_text_submit.

  • Щоб вийти з режиму редагування, натисніть ui_text_submit або ui_cancel (за замовчуванням Escape).

  • Перевірте дії edit(), unedit(), is_editing() та editing_toggled для отримання додаткової інформації.

Під час введення тексту можна вставляти спеціальні символи за допомогою кодів Unicode, OEM або Windows alt:

  • Щоб ввести кодові точки Unicode, утримуйте Alt та введіть кодову точку на цифровій клавіатурі. Наприклад, щоб ввести символ á (U+00E1), утримуйте Alt та введіть +E1 на цифровій клавіатурі (початкові нулі можна пропустити).

  • Щоб ввести коди OEM, утримуйте Alt та введіть код на цифровій клавіатурі. Наприклад, щоб ввести символ á (OEM 160), утримуйте Alt та введіть 160 на цифровій клавіатурі.

  • Щоб ввести коди Windows, утримуйте Alt та введіть код на цифровій клавіатурі. Наприклад, щоб ввести символ á (Windows 0225), утримуйте клавішу Alt та введіть 0, 2, 2, 5 на цифровій клавіатурі. Початковий нуль тут не можна пропускати, оскільки саме так кодові точки Windows відрізняються від кодових точок OEM.

Важливо:

  • Фокусування LineEdit за допомогою ui_focus_next (за замовчуванням Tab) або ui_focus_prev (за замовчуванням Shift + Tab) або Control.grab_focus() все одно переводить у режим редагування (для сумісності).

LineEdit має багато вбудованих комбінацій клавіш, які завжди доступні (Ctrl тут відповідає Cmd на macOS):

  • Ctrl + C: Копіювати

  • Ctrl + X: Вирізати

  • Ctrl + V або Ctrl + Y: Вставити/"витягнути"

  • Ctrl + Z: Скасувати

  • Ctrl + ~: Змінити напрямок введення.

  • Ctrl + Shift + Z: Повторити

  • Ctrl + U: Видалити текст від позиції каретки до початку рядка

  • Ctrl + K: Видалити текст від позиції каретки до кінця рядка

  • Ctrl + A: Виділити весь текст

  • Стрілка вгору/Стрілка вниз: Перемістити каретку на початок/кінець рядка

У macOS доступні деякі додаткові комбінації клавіш:

  • Cmd + F: Те саме, що й Стрілка вправо, перемістити каретку на один символ праворуч

  • Cmd + B: Те саме, що й Стрілка вліво, перемістити каретку на один символ ліворуч

  • Cmd + P: Те саме, що Стрілка вгору, перемістити каретку на попередній рядок

  • Cmd + N: Те саме, що й Стрілка вниз, перемістити каретку на наступний рядок

  • Cmd + D: Те саме, що й Delete, видалити символ праворуч від каретки

  • Cmd + H: Те саме, що й Backspace, видалити символ ліворуч від каретки

  • Cmd + A: Те саме, що й Home, перемістити каретку на початок рядка

  • Cmd + E: Те саме, що й End, перемістити каретку в кінець рядка

  • Cmd + Стрілка вліво: Те саме, що Home, перемістити каретку на початок рядка

  • Cmd + Стрілка вправо: Те саме, що й End, перемістити каретку в кінець рядка

Примітка: На перелічені вище комбінації клавіш для переміщення каретки не впливає shortcut_keys_enabled.

Властивості

HorizontalAlignment

alignment

0

bool

backspace_deletes_composite_character_enabled

false

bool

caret_blink

false

float

caret_blink_interval

0.65

int

caret_column

0

bool

caret_force_displayed

false

bool

caret_mid_grapheme

false

bool

clear_button_enabled

false

bool

context_menu_enabled

true

bool

deselect_on_focus_loss_enabled

true

bool

drag_and_drop_selection_enabled

true

bool

draw_control_chars

false

bool

editable

true

bool

emoji_menu_enabled

true

bool

expand_to_text_length

false

bool

flat

false

FocusMode

focus_mode

2 (overrides Control)

ExpandMode

icon_expand_mode

0

bool

keep_editing_on_text_submit

false

String

language

""

int

max_length

0

bool

middle_mouse_paste_enabled

true

CursorShape

mouse_default_cursor_shape

1 (overrides Control)

String

placeholder_text

""

Texture2D

right_icon

float

right_icon_scale

1.0

bool

secret

false

String

secret_character

"•"

bool

select_all_on_focus

false

bool

selecting_enabled

true

bool

shortcut_keys_enabled

true

StructuredTextParser

structured_text_bidi_override

0

Array

structured_text_bidi_override_options

[]

String

text

""

TextDirection

text_direction

0

bool

virtual_keyboard_enabled

true

bool

virtual_keyboard_show_on_focus

true

VirtualKeyboardType

virtual_keyboard_type

0

Методи

void

apply_ime()

void

cancel_ime()

void

clear()

void

delete_char_at_caret()

void

delete_text(from_column: int, to_column: int)

void

deselect()

void

edit(hide_focus: bool = false)

PopupMenu

get_menu() const

int

get_next_composite_character_column(column: int) const

int

get_previous_composite_character_column(column: int) const

float

get_scroll_offset() const

String

get_selected_text()

int

get_selection_from_column() const

int

get_selection_to_column() const

bool

has_ime_text() const

bool

has_redo() const

bool

has_selection() const

bool

has_undo() const

void

insert_text_at_caret(text: String)

bool

is_editing() const

bool

is_menu_visible() const

void

menu_option(option: int)

void

select(from: int = 0, to: int = -1)

void

select_all()

void

unedit()

Властивості теми

Color

caret_color

Color(0.95, 0.95, 0.95, 1)

Color

clear_button_color

Color(0.875, 0.875, 0.875, 1)

Color

clear_button_color_pressed

Color(1, 1, 1, 1)

Color

font_color

Color(0.875, 0.875, 0.875, 1)

Color

font_outline_color

Color(0, 0, 0, 1)

Color

font_placeholder_color

Color(0.875, 0.875, 0.875, 0.6)

Color

font_selected_color

Color(1, 1, 1, 1)

Color

font_uneditable_color

Color(0.875, 0.875, 0.875, 0.5)

Color

selection_color

Color(0.5, 0.5, 0.5, 1)

int

caret_width

1

int

minimum_character_width

4

int

outline_size

0

Font

font

int

font_size

Texture2D

clear

StyleBox

focus

StyleBox

normal

StyleBox

read_only

Сигнали

editing_toggled(toggled_on: bool) 🔗

Видається, коли LineEdit перемикається в режим редагування або виходить з нього.

text_change_rejected(rejected_substring: String) 🔗

Виникає під час додавання тексту, що переповнює max_length. Доданий текст скорочується до max_length, а частина, яка не поміститься, передається як аргумент rejected_substring.

text_changed(new_text: String) 🔗

Випробувано при зміні тексту.

text_submitted(new_text: String) 🔗

Видається, коли користувач натискає дію ui_text_submit (за замовчуванням: Enter або Kp Enter), коли LineEdit має фокус.

Переліки

enum MenuItems: 🔗

MenuItems MENU_CUT = 0

Вирізи (копії та очищення) вибраного тексту.

MenuItems MENU_COPY = 1

Скопіює вибраний текст.

MenuItems MENU_PASTE = 2

Вставте текст буфера над вибраним текстом (або на позиції догляду).

Недруковані символи втечу автоматично скомпедуються з клавіатури OS через String.strip_escapes().

MenuItems MENU_CLEAR = 3

Видаляє весь текст LineEdit.

MenuItems MENU_SELECT_ALL = 4

Виберіть текст LineEdit.

MenuItems MENU_UNDO = 5

Не додає попередньої дії.

MenuItems MENU_REDO = 6

Зворотній зв'язок.

MenuItems MENU_SUBMENU_TEXT_DIR = 7

Ідентифікатор субменю «Текстна записка».

MenuItems MENU_DIR_INHERITED = 8

Налаштовує текстовий напрямок у спадок.

MenuItems MENU_DIR_AUTO = 9

Налаштування текстового напрямку до автоматичного.

MenuItems MENU_DIR_LTR = 10

Встановлює напрямок тексту на ліву сторону.

MenuItems MENU_DIR_RTL = 11

Налаштовує текстовий напрямок до правого вліво.

MenuItems MENU_DISPLAY_UCC = 12

Вмикає/вимикає відображення керівних символів.

MenuItems MENU_SUBMENU_INSERT_UCC = 13

Ідентифікатор підменю «Вставити керуючий символ».

MenuItems MENU_INSERT_LRM = 14

Вставте ліву позначку (LRM).

MenuItems MENU_INSERT_RLM = 15

Вставки правого вліво позначки (RLM) характер.

MenuItems MENU_INSERT_LRE = 16

Вставки старту ліворучного тиснення (LRE) символу.

MenuItems MENU_INSERT_RLE = 17

Вставки стартують право-лівий тиснення (RLE) символу.

MenuItems MENU_INSERT_LRO = 18

Вставки старту ліворучного наднаряддя (LRO) персонажа.

MenuItems MENU_INSERT_RLO = 19

Вставки стартують право-лівий надряддя (RLO) символ.

MenuItems MENU_INSERT_PDF = 20

Вставки форматування поштового напрямку (PDF) символ.

MenuItems MENU_INSERT_ALM = 21

Вставки арабської марки літери (ALM).

MenuItems MENU_INSERT_LRI = 22

Вставки ліворучного ізоляту (LRI).

MenuItems MENU_INSERT_RLI = 23

Вставте правий-лівий ізолят (RLI) символ.

MenuItems MENU_INSERT_FSI = 24

Вставляє перший символ строгого ізоляту (FSI).

MenuItems MENU_INSERT_PDI = 25

Вставляє символ ізоляції напрямку виштовхування (PDI).

MenuItems MENU_INSERT_ZWJ = 26

Вставте нульову ширину стикувача (ZWJ) характер.

MenuItems MENU_INSERT_ZWNJ = 27

Вставляє символ нульової ширини, що не з'єднує елементи (ZWNJ).

MenuItems MENU_INSERT_WJ = 28

Вставте слово-приєднувач (WJ) символ.

MenuItems MENU_INSERT_SHY = 29

Вставки м'якого фена (ШІ) характеру.

MenuItems MENU_EMOJI_AND_SYMBOL = 30

Відкриває системний засіб вибору смайлів і символів.

MenuItems MENU_MAX = 31

Представляємо розмір MenuItems enum.

enum VirtualKeyboardType: 🔗

VirtualKeyboardType KEYBOARD_TYPE_DEFAULT = 0

За замовчуванням текст віртуальної клавіатури.

VirtualKeyboardType KEYBOARD_TYPE_MULTILINE = 1

Багатоканальна віртуальна клавіатура.

VirtualKeyboardType KEYBOARD_TYPE_NUMBER = 2

Віртуальний номер клавіатури, корисний для входу PIN.

VirtualKeyboardType KEYBOARD_TYPE_NUMBER_DECIMAL = 3

Віртуальний номер клавіатури, корисний для введення дробових чисел.

VirtualKeyboardType KEYBOARD_TYPE_PHONE = 4

Віртуальна телефонна клавіатура.

VirtualKeyboardType KEYBOARD_TYPE_EMAIL_ADDRESS = 5

Віртуальна клавіатура з додатковими ключами, щоб допомогти з налаштуванням електронних адрес.

VirtualKeyboardType KEYBOARD_TYPE_PASSWORD = 6

Віртуальна клавіатура для введення пароля. На більшості платформ, це слід відключити автозакінчення і автоматизацію.

Примітка: Це не підтримується на Веб-сайті. Замість цього, такі породи ідентично KEYBOARD_TYPE_DEFAULT.

VirtualKeyboardType KEYBOARD_TYPE_URL = 7

Віртуальна клавіатура з додатковими ключами, щоб допомогти з натисканням URL.

enum ExpandMode: 🔗

ExpandMode EXPAND_MODE_ORIGINAL_SIZE = 0

Використайте оригінальний розмір для правої значка.

ExpandMode EXPAND_MODE_FIT_TO_TEXT = 1

Масштабуйте розмір правої іконки відповідно до розміру тексту.

ExpandMode EXPAND_MODE_FIT_TO_LINE_EDIT = 2

Масштабуйте праву іконку відповідно до LineEdit.

Описи властивостей

HorizontalAlignment alignment = 0 🔗

Горизонтальне вирівнювання тексту.

bool backspace_deletes_composite_character_enabled = false 🔗

  • void set_backspace_deletes_composite_character_enabled(value: bool)

  • bool is_backspace_deletes_composite_character_enabled()

Якщо true та caret_mid_grapheme має значення false, клавіша Backspace видаляє цілий складений символ, наприклад ❤️‍🩹, а не частину складеного символу.

  • void set_caret_blink_enabled(value: bool)

  • bool is_caret_blink_enabled()

Якщо true, робить догляд за посиланням.

  • void set_caret_blink_interval(value: float)

  • float get_caret_blink_interval()

Проміжок, в якому доглядаються посилання (в секундах).

int caret_column = 0 🔗

  • void set_caret_column(value: int)

  • int get_caret_column()

Положення стовпчика вгорі LineEdit. При налаштуванні текст може прокручуватися, щоб вмістити його.

bool caret_force_displayed = false 🔗

  • void set_caret_force_displayed(value: bool)

  • bool is_caret_force_displayed()

Якщо true, LineEdit завжди показуватиме каретку, навіть якщо не редагувати або фокус буде втрачено.

bool caret_mid_grapheme = false 🔗

  • void set_caret_mid_grapheme_enabled(value: bool)

  • bool is_caret_mid_grapheme_enabled()

Дозволити рухомий догляд, вибрати і видалити окремі компоненти композитного характеру.

Примітка: Backspace завжди видаляє окремі компоненти композитного характеру.

bool clear_button_enabled = false 🔗

  • void set_clear_button_enabled(value: bool)

  • bool is_clear_button_enabled()

Якщо true, LineEdit покаже кнопку очищення, якщо text не порожній, що можна використовувати для швидкого очищення тексту.

bool context_menu_enabled = true 🔗

  • void set_context_menu_enabled(value: bool)

  • bool is_context_menu_enabled()

Якщо true, контекстне меню з'явиться при правильній завантаженні.

bool deselect_on_focus_loss_enabled = true 🔗

  • void set_deselect_on_focus_loss_enabled(value: bool)

  • bool is_deselect_on_focus_loss_enabled()

Якщо true, вибраний текст буде вилучено, коли фокус втрачено.

bool drag_and_drop_selection_enabled = true 🔗

  • void set_drag_and_drop_selection_enabled(value: bool)

  • bool is_drag_and_drop_selection_enabled()

Якщо true, дайте перетягування вибраного тексту.

bool draw_control_chars = false 🔗

  • void set_draw_control_chars(value: bool)

  • bool get_draw_control_chars()

Якщо true, відображаються символи керування.

bool editable = true 🔗

  • void set_editable(value: bool)

  • bool is_editable()

Якщо false, існуючий текст не може бути змінений і новий текст не можна додавати.

bool emoji_menu_enabled = true 🔗

  • void set_emoji_menu_enabled(value: bool)

  • bool is_emoji_menu_enabled()

Якщо true, меню «Емодзі та символи» ввімкнено.

bool expand_to_text_length = false 🔗

  • void set_expand_to_text_length_enabled(value: bool)

  • bool is_expand_to_text_length_enabled()

Якщо значення true, ширина LineEdit збільшиться, щоб залишатися довшою за text. Вона не стиснеться, якщо text скоротиться.

bool flat = false 🔗

  • void set_flat(value: bool)

  • bool is_flat()

Якщо true, LineEdit не відображається прикраса.

ExpandMode icon_expand_mode = 0 🔗

Визначте масштабування елемента right_icon.

bool keep_editing_on_text_submit = false 🔗

  • void set_keep_editing_on_text_submit(value: bool)

  • bool is_editing_kept_on_text_submit()

Якщо true, LineEdit не вийде з режиму редагування, коли текст надсилається натисканням кнопки ui_text_submit (за умовчанням: Enter або Kp Enter).

String language = "" 🔗

  • void set_language(value: String)

  • String get_language()

Код мови, що використовується для алгоритмів розриву рядків та формування тексту. Якщо залишити поле порожнім, використовується поточна локалізація.

int max_length = 0 🔗

  • void set_max_length(value: int)

  • int get_max_length()

Максимальна кількість символів, яку можна ввести всередині LineEdit. Якщо 0, обмеження немає.

Коли обмеження визначено, символи, що перевищують max_length, обрізаються. Це відбувається як для існуючого вмісту text під час встановлення максимальної довжини, так і для нового тексту, вставленого в LineEdit, включаючи вставку.

Якщо будь-який вхідний текст обрізається, випромінюється сигнал text_change_rejected зі обрізаним підрядком як параметром:

text = "Hello world"
max_length = 5
# `text` стає "Hello".
max_length = 10
text += " goodbye"
# `text` стає "Hello good".
# `text_change_rejected` випромінюється з параметром "bye".

bool middle_mouse_paste_enabled = true 🔗

  • void set_middle_mouse_paste_enabled(value: bool)

  • bool is_middle_mouse_paste_enabled()

Якщо false, використовуючи середню кнопку миші, щоб записувати буфер буде вимкнено.

Примітка: Цей метод реалізується тільки на Linux.

String placeholder_text = "" 🔗

  • void set_placeholder(value: String)

  • String get_placeholder()

Текст, що відображається, коли LineEdit порожній. Це не значення LineEdit за замовчуванням (див. text).

Texture2D right_icon 🔗

  • void set_right_icon(value: Texture2D)

  • Texture2D get_right_icon()

Встановлює піктограму, яка відображатиметься у правому кінці LineEdit, якщо немає text, або завжди, якщо clear_button_enabled має значення false.

float right_icon_scale = 1.0 🔗

  • void set_right_icon_scale(value: float)

  • float get_right_icon_scale()

Масштабування значка, коли для icon_expand_mode встановлено значення EXPAND_MODE_FIT_TO_LINE_EDIT.

bool secret = false 🔗

  • void set_secret(value: bool)

  • bool is_secret()

Якщо true, кожен символ замінюється секретним символом (див. secret_character).

String secret_character = "•" 🔗

  • void set_secret_character(value: String)

  • String get_secret_character()

Характер для використання маски секретного введення. Єдиний символ може використовуватися як секретний характер. Якщо він більше одного персонажа буде використовуватися тільки перший. Якщо це порожній, то простір буде використовуватися замість.

bool select_all_on_focus = false 🔗

  • void set_select_all_on_focus(value: bool)

  • bool is_select_all_on_focus()

Якщо true, LineEdit вибере весь текст, коли він отримує фокус.

bool selecting_enabled = true 🔗

  • void set_selecting_enabled(value: bool)

  • bool is_selecting_enabled()

Якщо false, можна вибрати текст за допомогою миші або клавіатури.

bool shortcut_keys_enabled = true 🔗

  • void set_shortcut_keys_enabled(value: bool)

  • bool is_shortcut_keys_enabled()

Якщо true, увімкнено комбінації клавіш для контекстного меню, навіть якщо контекстне меню вимкнено.

StructuredTextParser structured_text_bidi_override = 0 🔗

  • void set_structured_text_bidi_override(value: StructuredTextParser)

  • StructuredTextParser get_structured_text_bidi_override()

Настроювання алгоритму BiDi для структурованого тексту.

Array structured_text_bidi_override_options = [] 🔗

  • void set_structured_text_bidi_override_options(value: Array)

  • Array get_structured_text_bidi_override_options()

Налаштуйте додаткові параметри для перенади BiDi.

String text = "" 🔗

  • void set_text(value: String)

  • String get_text()

Рядкове значення LineEdit.

Примітка: Зміна тексту за допомогою цієї властивості не призведе до випромінювання сигналу text_changed.

TextDirection text_direction = 0 🔗

Основний напрямок написання тексту.

bool virtual_keyboard_enabled = true 🔗

  • void set_virtual_keyboard_enabled(value: bool)

  • bool is_virtual_keyboard_enabled()

Якщо значення true, рідна віртуальна клавіатура ввімкнена на платформах, які її підтримують.

bool virtual_keyboard_show_on_focus = true 🔗

  • void set_virtual_keyboard_show_on_focus(value: bool)

  • bool get_virtual_keyboard_show_on_focus()

Якщо значення true, рідна віртуальна клавіатура відображається під час подій focus на платформах, які її підтримують.

VirtualKeyboardType virtual_keyboard_type = 0 🔗

Визначає тип віртуальної клавіатури для відображення.

Описи методів

void apply_ime() 🔗

Застосовує текст із Редактора методів введення (IME) і закриває IME, якщо він відкритий.

void cancel_ime() 🔗

Закрити ` Вхід Редактор метода <https://en.wikipedia.org/wiki/Input_method>`__ (IME) якщо він відкритий. Будь-який текст в IME буде втрачено.

void clear() 🔗

Стирає елементи LineEdit text.

void delete_char_at_caret() 🔗

Видаляє один характер на поточному положенні опіки (еквівалент для пресування Delete).

void delete_text(from_column: int, to_column: int) 🔗

Видаляє розділ text переходячи від позиції from_column до to_column. Обидва параметри повинні бути в межах довжини тексту.

void deselect() 🔗

Очищає поточний вибір.

void edit(hide_focus: bool = false) 🔗

Дозволяє перейти в режим редагування, незалежно від того, чи перебуває фокус на LineEdit, чи ні. Якщо hide_focus має значення true, стан фокусування не відображатиметься (див. Control.grab_focus()).

Див. також keep_editing_on_text_submit.

PopupMenu get_menu() const 🔗

Повертає PopupMenu цього LineEdit. За замовчуванням це меню відображається, якщо клацнути правою кнопкою миші LineEdit.

Ви можете додати власні пункти меню або видалити стандартні. Переконайтеся, що ваші ідентифікатори не конфліктують зі стандартними (див. MenuItems). Наприклад:

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())

Попередження: Це обов’язковий внутрішній вузол, його видалення та звільнення може призвести до збою. Якщо ви бажаєте приховати його чи будь-який із його дочірніх елементів, скористайтеся властивістю Window.visible.

int get_next_composite_character_column(column: int) const 🔗

Повертає правильний стовпець у кінці складеного символу, наприклад, ❤️‍🩹 (загоєння серця; Unicode: U+2764 U+FE0F U+200D U+1FA79), який складається з більш ніж однієї кодової точки Unicode, якщо каретка знаходиться на початку складеного символу. Також повертає правильний стовпець з кареткою посередині графеми та для нескладених символів.

Примітка: Щоб перевірити розташування каретки, використовуйте get_next_composite_character_column(get_caret_column())

int get_previous_composite_character_column(column: int) const 🔗

Повертає правильний стовпець на початку складеного символу, наприклад, ❤️‍🩹 (загоєння серця; Unicode: U+2764 U+FE0F U+200D U+1FA79), який складається з більш ніж однієї кодової точки Unicode, якщо каретка знаходиться в кінці складеного символу. Також повертає правильний стовпець з кареткою посередині графеми та для нескладених символів.

Примітка: Щоб перевірити розташування каретки, використовуйте get_previous_composite_character_column(get_caret_column())

float get_scroll_offset() const 🔗

Повертає зміщення прокручування, зумовлене caret_column, у вигляді кількості символів.

String get_selected_text() 🔗

Повертаємо текст всередині вибору.

int get_selection_from_column() const 🔗

Повертаємо вибраний стовпчик.

int get_selection_to_column() const 🔗

Повертає кінець вибору стовпця.

bool has_ime_text() const 🔗

Повертає true, якщо користувач має текст у Input Method Editor (IME).

bool has_redo() const 🔗

Повертаємо true, якщо доступна акція "redo".

bool has_selection() const 🔗

Повертає true, якщо користувач вибрав текст.

bool has_undo() const 🔗

Повертаємо true, якщо доступна акція "undo".

void insert_text_at_caret(text: String) 🔗

Вставляє text на каретці. Якщо отримане значення довше за max_length, нічого не відбувається.

bool is_editing() const 🔗

Повертає інформацію про те, чи редагується LineEdit.

bool is_menu_visible() const 🔗

Повертаємо вашу увагу на те, що меню видно. Використовуйте це замість ``get_menu().видимі `` для поліпшення продуктивності (наприклад, створення меню уникнути).

void menu_option(option: int) 🔗

Виконує задану дію, як визначену в MenuItems enum.

void select(from: int = 0, to: int = -1) 🔗

Вибирає символи всередині LineEdit між from і to. За замовчуванням from знаходиться на початку, а to у кінці.

text = "Ласкаво просимо"
select() # Вибере "Ласкаво просимо".
select(4) # Вибере "ome".
select(2, 5) # Вибере "lco".

void select_all() 🔗

Виберіть все String.

void unedit() 🔗

Дозволяє вийти з режиму редагування зі збереженням фокусу.

Описи тематичної нерухомості

Color caret_color = Color(0.95, 0.95, 0.95, 1) 🔗

Колір догляду LineEdit Це може бути встановлений для повного прозорого кольору, щоб повністю приховати догляд.

Color clear_button_color = Color(0.875, 0.875, 0.875, 1) 🔗

Колір, який використовується як за замовчуванням для чіткої кнопки.

Color clear_button_color_pressed = Color(1, 1, 1, 1) 🔗

Колір використовується для чіткої кнопки при натисканні.

Color font_color = Color(0.875, 0.875, 0.875, 1) 🔗

Колір шрифту за замовчуванням.

Color font_outline_color = Color(0, 0, 0, 1) 🔗

Текст тексту LineEdit.

Color font_placeholder_color = Color(0.875, 0.875, 0.875, 0.6) 🔗

Колір шрифту для placeholder_text.

Color font_selected_color = Color(1, 1, 1, 1) 🔗

Колір шрифту для вибраного тексту (всередині вибору прямокутника).

Color font_uneditable_color = Color(0.875, 0.875, 0.875, 0.5) 🔗

Колір шрифту при редагування вимкнено.

Color selection_color = Color(0.5, 0.5, 0.5, 1) 🔗

Колір вибору прямокутника.

int caret_width = 1 🔗

Ширина догляду в пікселях. Більші значення можуть бути використані для поліпшення доступності шляхом забезпечення догляду легко видно, або забезпечити консистенцію з великим розміром шрифту.

int minimum_character_width = 4 🔗

Мінімальний горизонтальний простір для тексту (не підрахунок чіткої кнопки та запасів вмісту). Це значення вимірюється в кількості символів 'M' (тобто цей номер символів 'M' може відображатися без прокручування).

int outline_size = 0 🔗

Розмір контуру тексту.

Примітка. Якщо використовується шрифт із увімкненим FontFile.multichannel_signed_distance_field, для його FontFile.msdf_pixel_range має бути принаймні вдвічі значення outline_size щоб рендеринг контуру виглядав правильно. Інакше контур може здатися обрізаним раніше, ніж передбачалося.

Font font 🔗

Використовується для тексту.

int font_size 🔗

Розмір шрифту тексту LineEdit.

Texture2D clear 🔗

Текстура для кнопки очищення. Див. clear_button_enabled.

StyleBox focus 🔗

Підземелля використовується при LineEdit має фокус GUI. focus StyleBox відображається over бази StyleBox, тому для забезпечення бази StyleBox слід використовувати частково прозорий StyleBox. Стильбокс, який добре працює для цього. Щоб вимкнути візуальний ефект фокусу, призначте ресурс StyleBoxEmpty. Зверніть увагу, що відключення візуального ефекту фокусу буде завдати шкоди клавіатурі / керованій навігації, тому це не рекомендується для причин доступності.

StyleBox normal 🔗

За замовчуванням для LineEdit.

StyleBox read_only 🔗

Підземний використовується, коли LineEdit знаходиться в режимі зчитування (editable встановлюється до false).