LineEdit
Однострочное поле с выделением, ограничением длины и отдельными сигналами изменения/подтверждения.
Используйте LineEdit для имени, поиска или другой одной строки; многострочный редактор — TextEdit. Читайте Text как значение, а PlaceholderText как отдельную подсказку. Проверяйте введённые данные по правилам приложения: MaxLength ограничивает длину, но не допустимые символы или смысл.
Присваивание Text/SetText заменяет строку, сбрасывает выделение, курсор и прокрутку к началу и очищает прежнюю историю редактирования. Оно не испускает TextChanged. Для заполнения формы задайте Text, затем явно обновите зависимые элементы; для курсора в конце задайте CaretColumn после Text. Не используйте C# string.Length как индекс движка для строк с символами вне BMP.
Позиции CaretColumn, Select и DeleteText считаются в Unicode-кодовых точках, не в UTF-16 и не в видимых составных символах. Например, A😀é содержит 4 кодовые точки, но string.Length = 5. Для переходов через составной символ используйте GetNextCompositeCharacterColumn/GetPreviousCompositeCharacterColumn. CaretColumn ограничивается диапазоном от 0 до длины текста.
Select(from, to) выбирает полуинтервал [from, to), не двигая курсор. Отрицательный to означает конец строки. Select(0, 0) снимает выделение; обратный диапазон или равные ненулевые границы оставляют прежнее выделение. Перед GetSelectionFromColumn/GetSelectionToColumn проверяйте HasSelection. Deselect не меняет текст.
InsertTextAtCaret вставляет в текущую позицию, сдвигает курсор, но сам не заменяет выделение и не испускает TextChanged. Для замены выделения сохраните его границы, снимите выделение, вызовите DeleteText, установите CaretColumn в начало диапазона и вставьте строку. DeleteText меняет Text сразу, а TextChanged планирует отложенно, объединяя несколько таких удалений до уведомления. Clear испускает сигнал сразу, если поле было непустым.
MaxLength = 0 означает отсутствие ограничения. Положительное число ограничивает кодовые точки. При переполнении принимается доступный префикс, а TextChangeRejected получает отброшенный хвост. Изменение MaxLength повторно применяет Text: может обрезать строку и сбрасывает позицию/выделение даже при прежнем лимите. TextChangeRejected возможен и при программной записи, хотя TextChanged при этом не возникает.
Editable = false запрещает пользовательское редактирование, но не программные SetText, InsertTextAtCaret, DeleteText или Clear. Secret маскирует отображение, сохраняя исходный Text; это не шифрование и не защита от чтения вашим кодом. TextSubmitted относится к действию ui_text_submit (обычно Enter), не к присваиванию Text. Обрабатывайте подтверждение отдельно от изменения и проверяйте значение перед сохранением.
Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.
Конструкторы1
LineEditКонструктор
public LineEdit();Создаёт пустое редактируемое поле: MaxLength = 0, курсор 0, выделение разрешено, Secret выключен.
Свойства36
AlignmentСвойство
public HorizontalAlignment Alignment { get; set; }Горизонтальное выравнивание, Left по умолчанию. Left/Right учитывают направление раскладки; Fill растягивает пробелы через shaping, не переносит строку. Не задаёт CaretColumn.
BackspaceDeletesCompositeCharacterEnabledСвойство
public bool BackspaceDeletesCompositeCharacterEnabled { get; set; }Удалять перед курсором составной символ целиком при CaretMidGrapheme = false; false по умолчанию означает одну кодовую точку. Влияет также на DeleteCharAtCaret.
CaretBlinkСвойство
public bool CaretBlink { get; set; }Мигание курсора, false по умолчанию. Включение использует внутреннюю обработку кадров; видимость всё равно зависит от режима редактирования, фокуса или CaretForceDisplayed.
CaretBlinkIntervalСвойство
public float CaretBlinkInterval { get; set; }Интервал переключения видимости курсора в секундах, 0.65 по умолчанию. Требуется положительное конечное число; неположительное отклоняется. Имеет эффект при CaretBlink = true.
CaretColumnСвойство
public int CaretColumn { get; set; }Позиция курсора в Unicode-кодовых точках, не индекс UTF-16; 0 по умолчанию. Setter ограничивает 0…длина текста и подстраивает прокрутку для видимости курсора в дереве.
CaretForceDisplayedСвойство
public bool CaretForceDisplayed { get; set; }Показывать курсор вне обычного условия редактирования/фокуса, false по умолчанию. Не начинает редактирование и не включает Editable. Для элемента редактируемой сцены принудительный показ не применяется.
CaretMidGraphemeСвойство
public bool CaretMidGrapheme { get; set; }Разрешает курсору перемещение внутри составного символа, false по умолчанию. При true DeleteCharAtCaret удаляет одну кодовую точку даже с включённым удалением составных символов. Прямой CaretColumn сам не выравнивает индекс на границу графемы.
ClearButtonEnabledСвойство
public bool ClearButtonEnabled { get; set; }Встроенная кнопка очистки, false по умолчанию. Рисуется у непустого редактируемого поля вместо RightIcon; её место учитывается в минимуме и при пустом поле. Очистка меняет текст, не подтверждает строку.
ContextMenuEnabledСвойство
public bool ContextMenuEnabled { get; set; }Разрешает стандартное контекстное меню по вводу пользователя, true по умолчанию. false не запрещает GetMenu, прямой MenuOption или изменение текста из кода.
DeselectOnFocusLossEnabledСвойство
public bool DeselectOnFocusLossEnabled { get; set; }Снимать выделение при потере фокуса/завершении редактирования, true по умолчанию. Включение также сразу снимает выделение, если поле уже без фокуса. Перетаскивание имеет отдельные условия сохранения выделения.
DragAndDropSelectionEnabledСвойство
public bool DragAndDropSelectionEnabled { get; set; }Разрешает перетаскивание выделенного текста, true по умолчанию. Это отдельная политика от SelectingEnabled; не запрещает программные Select или запись Text.
DrawControlCharsСвойство
public bool DrawControlChars { get; set; }Визуализировать управляющие символы при shaping, false по умолчанию. Не добавляет управляющие символы в Text и не меняет правила проверки ввода.
EditableСвойство
public bool Editable { get; set; }Разрешает пользовательское редактирование, true по умолчанию. false не блокирует программные операции над текстом; при активном редактировании отключение завершает его.
EmojiMenuEnabledСвойство
public bool EmojiMenuEnabled { get; set; }Разрешает пункт системного выбора emoji/символов в стандартном меню, true по умолчанию. Нужна поддержка платформы; false не запрещает ввод emoji или программную вставку.
ExpandToTextLengthСвойство
public bool ExpandToTextLength { get; set; }Увеличивает минимальную ширину до ширины сформированного текста с местом для курсора, false по умолчанию. Может расширить родительский контейнер; для поля фиксированной ширины оставьте false.
FlatСвойство
public bool Flat { get; set; }Не рисовать фон normal/read_only, false по умолчанию. Отдельный focus-стиль продолжает рисоваться; поля этих стилей и минимум не исчезают.
IconExpandModeСвойство
public LineEdit.ExpandMode IconExpandMode { get; set; }Размер RightIcon и иконки очистки: OriginalSize использует исходные размеры; FitToText делает квадрат высотой шрифта; FitToLineEdit вписывает по высоте поля с ограничением ширины и применяет RightIconScale. По умолчанию OriginalSize. FitToText не сохраняет пропорции неквадратного изображения.
KeepEditingOnTextSubmitСвойство
public bool KeepEditingOnTextSubmit { get; set; }Продолжать редактирование после ui_text_submit, false по умолчанию. Не отменяет TextSubmitted и не выполняет проверку значения.
LanguageСвойство
public string Language { get; set; }Язык shaping, пустой по умолчанию использует локаль элемента. Не переводит Text и не переключает локаль приложения; задавайте код языка для корректного формирования письма.
MaxLengthСвойство
public int MaxLength { get; set; }Максимум Unicode-кодовых точек, 0 означает без ограничения. Требуется число ≥ 0. Setter повторно применяет текущий текст, может обрезать хвост и сбрасывает курсор/выделение; TextChanged не испускается.
MiddleMousePasteEnabledСвойство
public bool MiddleMousePasteEnabled { get; set; }Разрешает вставку primary selection средней кнопкой на поддерживаемой платформе, true по умолчанию. Отдельно от обычной вставки из clipboard; при false программные вставки остаются доступны.
PlaceholderTextСвойство
public string PlaceholderText { get; set; }Отдельная подсказка для пустого поля, пустая по умолчанию. Не входит в Text и не считается введённым значением; отображение использует перевод подсказки.
RightIconСвойство
public Texture2D RightIcon { get; set; }Общая Texture2D справа, null по умолчанию. В режиме RTL размещение зеркалится. Встроенная кнопка очистки имеет приоритет, когда видима. Изменения назначенной текстуры обновляют минимум; ресурс не копируется.
RightIconScaleСвойство
public float RightIconScale { get; set; }Множитель размера иконки только при IconExpandMode = FitToLineEdit, 1 по умолчанию. Другие режимы его игнорируют. Setter не ограничивает диапазон: используйте положительное конечное число, обычно 0.1–1.
SecretСвойство
public bool Secret { get; set; }Маскирует отображение, false по умолчанию. Text и GetSelectedText сохраняют исходные символы; это не шифрование или безопасное хранение пароля.
SecretCharacterСвойство
public string SecretCharacter { get; set; }Символ маски, • по умолчанию. Задавайте одну Unicode-кодовую точку: более длинная строка вызывает предупреждение и обрезается. Пустое значение рисуется стандартным •, не очищая Text.
SelectAllOnFocusСвойство
public bool SelectAllOnFocus { get; set; }Выделять весь текст при начале редактирования, false по умолчанию. При зажатой левой кнопке мыши выделение откладывается до отпускания. Не отменяет SelectingEnabled = false.
SelectingEnabledСвойство
public bool SelectingEnabled { get; set; }Разрешает выделение, true по умолчанию. Выключение снимает выделение; Select и SelectAll при false ничего не делают.
ShortcutKeysEnabledСвойство
public bool ShortcutKeysEnabled { get; set; }Разрешает встроенные сочетания редактирования, true по умолчанию. Не отключает обычный ввод и все навигационные действия, прямой MenuOption или программные записи Text.
StructuredTextBidiOverrideСвойство
public TextServer.StructuredTextParser StructuredTextBidiOverride { get; set; }Правило BiDi для структурированных строк, Default по умолчанию. Uri/File/Email/List сохраняют смысл частей смешанной строки; Custom использует callback Control. Не меняет исходный Text.
StructuredTextBidiOverrideOptionsСвойство
public Reckfell.Collections.Array StructuredTextBidiOverrideOptions { get; set; }Общий Array параметров BiDi-парсера. Getter и setter разделяют контейнер; изменение alias не запускает shaping. Для обновления создайте копию до изменения и назначьте её через setter.
TextСвойство
public string Text { get; set; }Исходное значение поля, пустое по умолчанию. Setter заменяет текст с учётом MaxLength, очищает выделение/прежнюю историю и сбрасывает курсор/прокрутку в начало. TextChanged не испускается; переполнение может испустить TextChangeRejected.
TextDirectionСвойство
public Control.TextDirection TextDirection { get; set; }Направление формирования текста, Auto по умолчанию. Inherited берёт направление раскладки; Ltr/Rtl задают направление явно. Не переписывает строку в обратном порядке и не заменяет LayoutDirection.
VirtualKeyboardEnabledСвойство
public bool VirtualKeyboardEnabled { get; set; }Разрешает запросы виртуальной клавиатуры на поддерживаемой платформе, true по умолчанию. Не создаёт собственную клавиатуру и не запрещает аппаратный ввод при false.
VirtualKeyboardShowOnFocusСвойство
public bool VirtualKeyboardShowOnFocus { get; set; }Запрашивать виртуальную клавиатуру при получении фокуса, true по умолчанию. Нужны VirtualKeyboardEnabled и поддержка платформы. Явный Edit может запросить клавиатуру и при false.
VirtualKeyboardTypeСвойство
public LineEdit.VirtualKeyboardTypeEnum VirtualKeyboardType { get; set; }Подсказка платформе о типе клавиатуры, Default по умолчанию. Number/EmailAddress и другие варианты не фильтруют Text и не заменяют проверку введённых данных.
Методы98
ApplyImevoid
public void ApplyIme();Применяет текущую композицию через InsertTextAtCaret и закрывает IME-окно. Учитывает MaxLength, но сам не испускает TextChanged и не заменяет выделение как операция ввода. Без композиции только закрывает IME-окно при поддержке платформы.
CancelImevoid
public void CancelIme();Отменяет незавершённую IME-композицию и закрывает IME-окно, не вставляя её в Text. Не отменяет уже подтверждённый текст и не является Undo.
Clearvoid
public void Clear();Очищает текст, выделение и историю, сбрасывает курсор/прокрутку. Испускает TextChanged сразу только при непустом прежнем тексте. Работает и при Editable = false.
DeleteCharAtCaretvoid
public void DeleteCharAtCaret();Удаляет символ перед курсором и испускает TextChanged сразу. По умолчанию удаляет одну кодовую точку; при BackspaceDeletesCompositeCharacterEnabled = true и CaretMidGrapheme = false удаляет предыдущий составной символ. В начале или пустом поле ничего не делает. Не является удалением выделения.
DeleteTextvoid
public void DeleteText(int fromColumn, int toColumn);Удаляет [fromColumn, toColumn) в кодовых точках; требуется 0 ≤ fromColumn ≤ toColumn ≤ длина. Текст/курсор меняются сразу, TextChanged в дереве планируется отложенно, несколько удалений до вызова объединяются. Метод не снимает выделение автоматически; управляйте им отдельно.
| Имя | Тип | По умолчанию |
|---|---|---|
fromColumn | int | — |
toColumn | int | — |
fromColumnНачало полуинтервала в Unicode-кодовых точках; для DeleteText требуется допустимый индекс.
toColumnИсключённый конец в кодовых точках. Только Select принимает отрицательное значение как конец строки.
Deselectvoid
public void Deselect();Снимает выделение и сбрасывает его границы, не меняя текст или позицию курсора.
Edit2 перегрузки
public void Edit();Начинает редактирование в дереве; при необходимости сначала запрашивает фокус. Требует Editable. hideFocus скрывает индикацию запрошенного фокуса, не сам ввод. При уже имеющемся фокусе прямой Edit меняет состояние без EditingToggled; при получении фокуса сигнал может прийти по пути FocusEnter. Явный Edit запрашивает виртуальную клавиатуру независимо от VirtualKeyboardShowOnFocus, но учитывает VirtualKeyboardEnabled и поддержку платформы.
public void Edit(bool hideFocus = false);Начинает редактирование в дереве; при необходимости сначала запрашивает фокус. Требует Editable. hideFocus скрывает индикацию запрошенного фокуса, не сам ввод. При уже имеющемся фокусе прямой Edit меняет состояние без EditingToggled; при получении фокуса сигнал может прийти по пути FocusEnter. Явный Edit запрашивает виртуальную клавиатуру независимо от VirtualKeyboardShowOnFocus, но учитывает VirtualKeyboardEnabled и поддержку платформы.
| Имя | Тип | По умолчанию |
|---|---|---|
hideFocus | bool | false |
hideFocusСкрыть индикацию фокуса при его получении через Edit.
GetCaretBlinkIntervalfloat
public float GetCaretBlinkInterval();Интервал переключения видимости курсора в секундах, 0.65 по умолчанию. Требуется положительное конечное число; неположительное отклоняется. Имеет эффект при CaretBlink = true.
floatИнтервал переключения в секундах.
GetCaretColumnint
public int GetCaretColumn();Позиция курсора в Unicode-кодовых точках, не индекс UTF-16; 0 по умолчанию. Setter ограничивает 0…длина текста и подстраивает прокрутку для видимости курсора в дереве.
intТекущая колонка курсора в кодовых точках.
GetDrawControlCharsbool
public bool GetDrawControlChars();Визуализировать управляющие символы при shaping, false по умолчанию. Не добавляет управляющие символы в Text и не меняет правила проверки ввода.
boolФлаг визуализации управляющих символов.
GetHorizontalAlignmentHorizontalAlignment
public HorizontalAlignment GetHorizontalAlignment();Горизонтальное выравнивание, Left по умолчанию. Left/Right учитывают направление раскладки; Fill растягивает пробелы через shaping, не переносит строку. Не задаёт CaretColumn.
HorizontalAlignmentТекущий HorizontalAlignment.
GetIconExpandModeLineEdit.ExpandMode
public LineEdit.ExpandMode GetIconExpandMode();Размер RightIcon и иконки очистки: OriginalSize использует исходные размеры; FitToText делает квадрат высотой шрифта; FitToLineEdit вписывает по высоте поля с ограничением ширины и применяет RightIconScale. По умолчанию OriginalSize. FitToText не сохраняет пропорции неквадратного изображения.
LineEdit.ExpandModeТекущий LineEdit.ExpandMode.
GetLanguagestring
public string GetLanguage();Язык shaping, пустой по умолчанию использует локаль элемента. Не переводит Text и не переключает локаль приложения; задавайте код языка для корректного формирования письма.
stringЯзык shaping либо пустая строка для локали элемента.
GetMaxLengthint
public int GetMaxLength();Максимум Unicode-кодовых точек, 0 означает без ограничения. Требуется число ≥ 0. Setter повторно применяет текущий текст, может обрезать хвост и сбрасывает курсор/выделение; TextChanged не испускается.
intЛимит кодовых точек; 0 означает без ограничения.
GetMenuPopupMenu
public PopupMenu GetMenu();Лениво создаёт и возвращает внутренний PopupMenu, принадлежащий LineEdit. Не освобождайте и не удаляйте его. GetMenu работает и при ContextMenuEnabled = false; сам меню не открывает. Встроенные пункты обновляются перед показом; сохраняйте их ID и не подменяйте обработчик встроенных команд.
PopupMenuОбщий внутренний PopupMenu, принадлежащий полю.
GetNextCompositeCharacterColumnint
public int GetNextCompositeCharacterColumn(int column);Возвращает позицию после составного символа по результату shaping. Требуется колонка 0…длина в кодовых точках; в конце возвращает ту же позицию.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnТекущая позиция в кодовых точках: 0…длина Text, не индекс UTF-16.
intСледующая граница составного символа в кодовых точках; в конце текущая позиция.
GetPlaceholderstring
public string GetPlaceholder();Отдельная подсказка для пустого поля, пустая по умолчанию. Не входит в Text и не считается введённым значением; отображение использует перевод подсказки.
stringИсходная строка подсказки, не введённое значение.
GetPreviousCompositeCharacterColumnint
public int GetPreviousCompositeCharacterColumn(int column);Возвращает позицию перед составным символом по результату shaping. Требуется колонка 0…длина в кодовых точках; в начале возвращает 0.
| Имя | Тип | По умолчанию |
|---|---|---|
column | int | — |
columnТекущая позиция в кодовых точках: 0…длина Text, не индекс UTF-16.
intПредыдущая граница составного символа в кодовых точках; в начале 0.
GetRightIconTexture2D
public Texture2D GetRightIcon();Общая Texture2D справа, null по умолчанию. В режиме RTL размещение зеркалится. Встроенная кнопка очистки имеет приоритет, когда видима. Изменения назначенной текстуры обновляют минимум; ресурс не копируется.
Texture2DОбщая Texture2D либо null.
GetRightIconScalefloat
public float GetRightIconScale();Множитель размера иконки только при IconExpandMode = FitToLineEdit, 1 по умолчанию. Другие режимы его игнорируют. Setter не ограничивает диапазон: используйте положительное конечное число, обычно 0.1–1.
floatСохранённый множитель размера FitToLineEdit.
GetScrollOffsetfloat
public float GetScrollOffset();Возвращает горизонтальный сдвиг рисования текста в локальных пикселях, обычно ≤ 0. Это не индекс символа и не положительная позиция ScrollBar; меняется при подстройке видимости курсора.
floatСдвиг рисования текста в локальных пикселях.
GetSecretCharacterstring
public string GetSecretCharacter();Символ маски, • по умолчанию. Задавайте одну Unicode-кодовую точку: более длинная строка вызывает предупреждение и обрезается. Пустое значение рисуется стандартным •, не очищая Text.
stringСохранённый символ маски либо пустая строка.
GetSelectedTextstring
public string GetSelectedText();Возвращает выделенный фрагмент исходного Text, даже в Secret-режиме; без выделения — пустую строку.
stringВыделенный исходный текст либо пустая строка.
GetSelectionFromColumnint
public int GetSelectionFromColumn();Возвращает начало выделения в кодовых точках. Сначала проверьте HasSelection: без выделения метод сообщает ошибку и возвращает -1.
intНачальная включённая колонка; без выделения -1 с ошибкой.
GetSelectionToColumnint
public int GetSelectionToColumn();Возвращает исключённый конец выделения в кодовых точках. Сначала проверьте HasSelection: без выделения сообщает ошибку и возвращает -1.
intКонечная исключённая колонка; без выделения -1 с ошибкой.
GetStructuredTextBidiOverrideTextServer.StructuredTextParser
public TextServer.StructuredTextParser GetStructuredTextBidiOverride();Правило BiDi для структурированных строк, Default по умолчанию. Uri/File/Email/List сохраняют смысл частей смешанной строки; Custom использует callback Control. Не меняет исходный Text.
TextServer.StructuredTextParserВыбранный TextServer.StructuredTextParser.
GetStructuredTextBidiOverrideOptionsReckfell.Collections.Array
public Reckfell.Collections.Array GetStructuredTextBidiOverrideOptions();Общий Array параметров BiDi-парсера. Getter и setter разделяют контейнер; изменение alias не запускает shaping. Для обновления создайте копию до изменения и назначьте её через setter.
Reckfell.Collections.ArrayArray параметров с общим содержимым.
GetTextstring
public string GetText();Исходное значение поля, пустое по умолчанию. Setter заменяет текст с учётом MaxLength, очищает выделение/прежнюю историю и сбрасывает курсор/прокрутку в начало. TextChanged не испускается; переполнение может испустить TextChangeRejected.
stringИсходный текст поля без маски и подсказки.
GetTextDirectionControl.TextDirection
public Control.TextDirection GetTextDirection();Направление формирования текста, Auto по умолчанию. Inherited берёт направление раскладки; Ltr/Rtl задают направление явно. Не переписывает строку в обратном порядке и не заменяет LayoutDirection.
Control.TextDirectionВыбранный Control.TextDirection.
GetVirtualKeyboardShowOnFocusbool
public bool GetVirtualKeyboardShowOnFocus();Запрашивать виртуальную клавиатуру при получении фокуса, true по умолчанию. Нужны VirtualKeyboardEnabled и поддержка платформы. Явный Edit может запросить клавиатуру и при false.
boolФлаг запроса клавиатуры при фокусе.
GetVirtualKeyboardTypeLineEdit.VirtualKeyboardTypeEnum
public LineEdit.VirtualKeyboardTypeEnum GetVirtualKeyboardType();Подсказка платформе о типе клавиатуры, Default по умолчанию. Number/EmailAddress и другие варианты не фильтруют Text и не заменяют проверку введённых данных.
LineEdit.VirtualKeyboardTypeEnumПодсказка LineEdit.VirtualKeyboardTypeEnum.
HasImeTextbool
public bool HasImeText();Есть ли незавершённая IME-композиция. Она отображается отдельно от подтверждённого Text; false не означает, что платформа вообще не поддерживает IME.
booltrue при незавершённой композиции.
HasRedobool
public bool HasRedo();Есть ли следующее состояние после отмены. Новое редактирование может сбросить эту ветку; Editable = false отдельно запрещает выполнение Redo.
booltrue при доступном следующем состоянии истории.
HasSelectionbool
public bool HasSelection();Проверяет активное выделение. Используйте перед чтением его границ.
booltrue при активном выделении.
HasUndobool
public bool HasUndo();Есть ли доступное предыдущее состояние в истории. Не означает, что отмена разрешена при Editable = false. Clear перестраивает историю, но предыдущее значение может оставаться доступным для отмены; не считайте очистку безопасным стиранием данных.
booltrue при доступном предыдущем состоянии истории.
InsertTextAtCaretvoid
public void InsertTextAtCaret(string text);Вставляет текст у курсора и сдвигает его за принятый фрагмент. Учитывает MaxLength и испускает TextChangeRejected для хвоста. Сам не удаляет выделение, не проверяет Editable и не испускает TextChanged.
| Имя | Тип | По умолчанию |
|---|---|---|
text | string | — |
textВставляет текст у курсора и сдвигает его за принятый фрагмент. Учитывает MaxLength и испускает TextChangeRejected для хвоста. Сам не удаляет выделение, не проверяет Editable и не испускает TextChanged.
IsBackspaceDeletesCompositeCharacterEnabledbool
public bool IsBackspaceDeletesCompositeCharacterEnabled();Удалять перед курсором составной символ целиком при CaretMidGrapheme = false; false по умолчанию означает одну кодовую точку. Влияет также на DeleteCharAtCaret.
boolФлаг удаления составных символов при CaretMidGrapheme = false.
IsCaretBlinkEnabledbool
public bool IsCaretBlinkEnabled();Мигание курсора, false по умолчанию. Включение использует внутреннюю обработку кадров; видимость всё равно зависит от режима редактирования, фокуса или CaretForceDisplayed.
boolСохранённый флаг CaretBlink.
IsCaretForceDisplayedbool
public bool IsCaretForceDisplayed();Показывать курсор вне обычного условия редактирования/фокуса, false по умолчанию. Не начинает редактирование и не включает Editable. Для элемента редактируемой сцены принудительный показ не применяется.
boolСохранённый флаг CaretForceDisplayed.
IsCaretMidGraphemeEnabledbool
public bool IsCaretMidGraphemeEnabled();Разрешает курсору перемещение внутри составного символа, false по умолчанию. При true DeleteCharAtCaret удаляет одну кодовую точку даже с включённым удалением составных символов. Прямой CaretColumn сам не выравнивает индекс на границу графемы.
boolРазрешено ли перемещение внутри составных символов.
IsClearButtonEnabledbool
public bool IsClearButtonEnabled();Встроенная кнопка очистки, false по умолчанию. Рисуется у непустого редактируемого поля вместо RightIcon; её место учитывается в минимуме и при пустом поле. Очистка меняет текст, не подтверждает строку.
boolСохранённый флаг ClearButtonEnabled.
IsContextMenuEnabledbool
public bool IsContextMenuEnabled();Разрешает стандартное контекстное меню по вводу пользователя, true по умолчанию. false не запрещает GetMenu, прямой MenuOption или изменение текста из кода.
boolСохранённый флаг ContextMenuEnabled.
IsDeselectOnFocusLossEnabledbool
public bool IsDeselectOnFocusLossEnabled();Снимать выделение при потере фокуса/завершении редактирования, true по умолчанию. Включение также сразу снимает выделение, если поле уже без фокуса. Перетаскивание имеет отдельные условия сохранения выделения.
boolСохранённый флаг DeselectOnFocusLossEnabled.
IsDragAndDropSelectionEnabledbool
public bool IsDragAndDropSelectionEnabled();Разрешает перетаскивание выделенного текста, true по умолчанию. Это отдельная политика от SelectingEnabled; не запрещает программные Select или запись Text.
boolСохранённый флаг DragAndDropSelectionEnabled.
IsEditablebool
public bool IsEditable();Разрешает пользовательское редактирование, true по умолчанию. false не блокирует программные операции над текстом; при активном редактировании отключение завершает его.
boolФлаг разрешения пользовательского редактирования.
IsEditingbool
public bool IsEditing();Возвращает режим редактирования, отдельный от Editable и HasFocus. Поле может иметь фокус после Unedit, оставаясь вне редактирования.
boolТекущее состояние редактирования.
IsEditingKeptOnTextSubmitbool
public bool IsEditingKeptOnTextSubmit();Продолжать редактирование после ui_text_submit, false по умолчанию. Не отменяет TextSubmitted и не выполняет проверку значения.
boolПродолжать ли редактирование после подтверждения.
IsEmojiMenuEnabledbool
public bool IsEmojiMenuEnabled();Разрешает пункт системного выбора emoji/символов в стандартном меню, true по умолчанию. Нужна поддержка платформы; false не запрещает ввод emoji или программную вставку.
boolСохранённый флаг EmojiMenuEnabled.
IsExpandToTextLengthEnabledbool
public bool IsExpandToTextLengthEnabled();Увеличивает минимальную ширину до ширины сформированного текста с местом для курсора, false по умолчанию. Может расширить родительский контейнер; для поля фиксированной ширины оставьте false.
boolСохранённый флаг ExpandToTextLength.
IsFlatbool
public bool IsFlat();Не рисовать фон normal/read_only, false по умолчанию. Отдельный focus-стиль продолжает рисоваться; поля этих стилей и минимум не исчезают.
boolСохранённый флаг Flat.
IsMenuVisiblebool
public bool IsMenuVisible();Возвращает видимость созданного контекстного меню; до его создания false. Сам меню не создаёт.
booltrue, если внутреннее меню существует и видно.
IsMiddleMousePasteEnabledbool
public bool IsMiddleMousePasteEnabled();Разрешает вставку primary selection средней кнопкой на поддерживаемой платформе, true по умолчанию. Отдельно от обычной вставки из clipboard; при false программные вставки остаются доступны.
boolСохранённый флаг MiddleMousePasteEnabled.
IsSecretbool
public bool IsSecret();Маскирует отображение, false по умолчанию. Text и GetSelectedText сохраняют исходные символы; это не шифрование или безопасное хранение пароля.
boolФлаг маскирования отображения.
IsSelectAllOnFocusbool
public bool IsSelectAllOnFocus();Выделять весь текст при начале редактирования, false по умолчанию. При зажатой левой кнопке мыши выделение откладывается до отпускания. Не отменяет SelectingEnabled = false.
boolСохранённый флаг SelectAllOnFocus.
IsSelectingEnabledbool
public bool IsSelectingEnabled();Разрешает выделение, true по умолчанию. Выключение снимает выделение; Select и SelectAll при false ничего не делают.
boolФлаг разрешения выделения.
IsShortcutKeysEnabledbool
public bool IsShortcutKeysEnabled();Разрешает встроенные сочетания редактирования, true по умолчанию. Не отключает обычный ввод и все навигационные действия, прямой MenuOption или программные записи Text.
boolСохранённый флаг ShortcutKeysEnabled.
IsVirtualKeyboardEnabledbool
public bool IsVirtualKeyboardEnabled();Разрешает запросы виртуальной клавиатуры на поддерживаемой платформе, true по умолчанию. Не создаёт собственную клавиатуру и не запрещает аппаратный ввод при false.
boolСохранённый флаг VirtualKeyboardEnabled.
MenuOptionvoid
public void MenuOption(int option);Выполняет команду по числовому значению LineEdit.MenuItems, не по индексу пункта PopupMenu. ContextMenuEnabled не блокирует этот вызов. Clear/Cut/Paste/Undo/Redo проверяют Editable; SelectAll проверяет SelectingEnabled. Clipboard/emoji-команды могут обращаться к ОС. Для собственных пунктов используйте собственный обработчик, а не произвольный MenuOption.
| Имя | Тип | По умолчанию |
|---|---|---|
option | int | — |
optionЧисловое значение встроенного LineEdit.MenuItems, не индекс меню.
Selectvoid
public void Select(int from = 0, int to = -1);Выделяет [from, to) в кодовых точках, не двигая курсор. from ограничивается 0…длина; отрицательный или слишком большой to означает конец. (0, 0) снимает выделение; from ≥ to после нормализации оставляет прежнее выделение. При SelectingEnabled = false ничего не делает.
| Имя | Тип | По умолчанию |
|---|---|---|
from | int | 0 |
to | int | -1 |
fromНачало полуинтервала в Unicode-кодовых точках; для DeleteText требуется допустимый индекс.
toИсключённый конец в кодовых точках. Только Select принимает отрицательное значение как конец строки.
SelectAllvoid
public void SelectAll();Выделяет весь непустой текст, если SelectingEnabled включён. Не двигает курсор непустого поля; в пустом поле ставит его в 0.
SetBackspaceDeletesCompositeCharacterEnabledvoid
public void SetBackspaceDeletesCompositeCharacterEnabled(bool enable);Удалять перед курсором составной символ целиком при CaretMidGrapheme = false; false по умолчанию означает одну кодовую точку. Влияет также на DeleteCharAtCaret.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableУдалять перед курсором составной символ целиком при CaretMidGrapheme = false; false по умолчанию означает одну кодовую точку. Влияет также на DeleteCharAtCaret.
SetCaretBlinkEnabledvoid
public void SetCaretBlinkEnabled(bool enabled);Мигание курсора, false по умолчанию. Включение использует внутреннюю обработку кадров; видимость всё равно зависит от режима редактирования, фокуса или CaretForceDisplayed.
| Имя | Тип | По умолчанию |
|---|---|---|
enabled | bool | — |
enabledМигание курсора, false по умолчанию. Включение использует внутреннюю обработку кадров; видимость всё равно зависит от режима редактирования, фокуса или CaretForceDisplayed.
SetCaretBlinkIntervalvoid
public void SetCaretBlinkInterval(float interval);Интервал переключения видимости курсора в секундах, 0.65 по умолчанию. Требуется положительное конечное число; неположительное отклоняется. Имеет эффект при CaretBlink = true.
| Имя | Тип | По умолчанию |
|---|---|---|
interval | float | — |
intervalИнтервал переключения видимости курсора в секундах, 0.65 по умолчанию. Требуется положительное конечное число; неположительное отклоняется. Имеет эффект при CaretBlink = true.
SetCaretColumnvoid
public void SetCaretColumn(int position);Позиция курсора в Unicode-кодовых точках, не индекс UTF-16; 0 по умолчанию. Setter ограничивает 0…длина текста и подстраивает прокрутку для видимости курсора в дереве.
| Имя | Тип | По умолчанию |
|---|---|---|
position | int | — |
positionПозиция курсора в Unicode-кодовых точках, не индекс UTF-16; 0 по умолчанию. Setter ограничивает 0…длина текста и подстраивает прокрутку для видимости курсора в дереве.
SetCaretForceDisplayedvoid
public void SetCaretForceDisplayed(bool enabled);Показывать курсор вне обычного условия редактирования/фокуса, false по умолчанию. Не начинает редактирование и не включает Editable. Для элемента редактируемой сцены принудительный показ не применяется.
| Имя | Тип | По умолчанию |
|---|---|---|
enabled | bool | — |
enabledПоказывать курсор вне обычного условия редактирования/фокуса, false по умолчанию. Не начинает редактирование и не включает Editable. Для элемента редактируемой сцены принудительный показ не применяется.
SetCaretMidGraphemeEnabledvoid
public void SetCaretMidGraphemeEnabled(bool enabled);Разрешает курсору перемещение внутри составного символа, false по умолчанию. При true DeleteCharAtCaret удаляет одну кодовую точку даже с включённым удалением составных символов. Прямой CaretColumn сам не выравнивает индекс на границу графемы.
| Имя | Тип | По умолчанию |
|---|---|---|
enabled | bool | — |
enabledРазрешает курсору перемещение внутри составного символа, false по умолчанию. При true DeleteCharAtCaret удаляет одну кодовую точку даже с включённым удалением составных символов. Прямой CaretColumn сам не выравнивает индекс на границу графемы.
SetClearButtonEnabledvoid
public void SetClearButtonEnabled(bool enable);Встроенная кнопка очистки, false по умолчанию. Рисуется у непустого редактируемого поля вместо RightIcon; её место учитывается в минимуме и при пустом поле. Очистка меняет текст, не подтверждает строку.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableВстроенная кнопка очистки, false по умолчанию. Рисуется у непустого редактируемого поля вместо RightIcon; её место учитывается в минимуме и при пустом поле. Очистка меняет текст, не подтверждает строку.
SetContextMenuEnabledvoid
public void SetContextMenuEnabled(bool enable);Разрешает стандартное контекстное меню по вводу пользователя, true по умолчанию. false не запрещает GetMenu, прямой MenuOption или изменение текста из кода.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableРазрешает стандартное контекстное меню по вводу пользователя, true по умолчанию. false не запрещает GetMenu, прямой MenuOption или изменение текста из кода.
SetDeselectOnFocusLossEnabledvoid
public void SetDeselectOnFocusLossEnabled(bool enable);Снимать выделение при потере фокуса/завершении редактирования, true по умолчанию. Включение также сразу снимает выделение, если поле уже без фокуса. Перетаскивание имеет отдельные условия сохранения выделения.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableСнимать выделение при потере фокуса/завершении редактирования, true по умолчанию. Включение также сразу снимает выделение, если поле уже без фокуса. Перетаскивание имеет отдельные условия сохранения выделения.
SetDragAndDropSelectionEnabledvoid
public void SetDragAndDropSelectionEnabled(bool enable);Разрешает перетаскивание выделенного текста, true по умолчанию. Это отдельная политика от SelectingEnabled; не запрещает программные Select или запись Text.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableРазрешает перетаскивание выделенного текста, true по умолчанию. Это отдельная политика от SelectingEnabled; не запрещает программные Select или запись Text.
SetDrawControlCharsvoid
public void SetDrawControlChars(bool enable);Визуализировать управляющие символы при shaping, false по умолчанию. Не добавляет управляющие символы в Text и не меняет правила проверки ввода.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableВизуализировать управляющие символы при shaping, false по умолчанию. Не добавляет управляющие символы в Text и не меняет правила проверки ввода.
SetEditablevoid
public void SetEditable(bool enabled);Разрешает пользовательское редактирование, true по умолчанию. false не блокирует программные операции над текстом; при активном редактировании отключение завершает его.
| Имя | Тип | По умолчанию |
|---|---|---|
enabled | bool | — |
enabledРазрешает пользовательское редактирование, true по умолчанию. false не блокирует программные операции над текстом; при активном редактировании отключение завершает его.
SetEmojiMenuEnabledvoid
public void SetEmojiMenuEnabled(bool enable);Разрешает пункт системного выбора emoji/символов в стандартном меню, true по умолчанию. Нужна поддержка платформы; false не запрещает ввод emoji или программную вставку.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableРазрешает пункт системного выбора emoji/символов в стандартном меню, true по умолчанию. Нужна поддержка платформы; false не запрещает ввод emoji или программную вставку.
SetExpandToTextLengthEnabledvoid
public void SetExpandToTextLengthEnabled(bool enabled);Увеличивает минимальную ширину до ширины сформированного текста с местом для курсора, false по умолчанию. Может расширить родительский контейнер; для поля фиксированной ширины оставьте false.
| Имя | Тип | По умолчанию |
|---|---|---|
enabled | bool | — |
enabledУвеличивает минимальную ширину до ширины сформированного текста с местом для курсора, false по умолчанию. Может расширить родительский контейнер; для поля фиксированной ширины оставьте false.
SetFlatvoid
public void SetFlat(bool enabled);Не рисовать фон normal/read_only, false по умолчанию. Отдельный focus-стиль продолжает рисоваться; поля этих стилей и минимум не исчезают.
| Имя | Тип | По умолчанию |
|---|---|---|
enabled | bool | — |
enabledНе рисовать фон normal/read_only, false по умолчанию. Отдельный focus-стиль продолжает рисоваться; поля этих стилей и минимум не исчезают.
SetHorizontalAlignmentvoid
public void SetHorizontalAlignment(HorizontalAlignment alignment);Горизонтальное выравнивание, Left по умолчанию. Left/Right учитывают направление раскладки; Fill растягивает пробелы через shaping, не переносит строку. Не задаёт CaretColumn.
| Имя | Тип | По умолчанию |
|---|---|---|
alignment | HorizontalAlignment | — |
alignmentГоризонтальное выравнивание, Left по умолчанию. Left/Right учитывают направление раскладки; Fill растягивает пробелы через shaping, не переносит строку. Не задаёт CaretColumn.
SetIconExpandModevoid
public void SetIconExpandMode(LineEdit.ExpandMode mode);Размер RightIcon и иконки очистки: OriginalSize использует исходные размеры; FitToText делает квадрат высотой шрифта; FitToLineEdit вписывает по высоте поля с ограничением ширины и применяет RightIconScale. По умолчанию OriginalSize. FitToText не сохраняет пропорции неквадратного изображения.
| Имя | Тип | По умолчанию |
|---|---|---|
mode | LineEdit.ExpandMode | — |
modeРазмер RightIcon и иконки очистки: OriginalSize использует исходные размеры; FitToText делает квадрат высотой шрифта; FitToLineEdit вписывает по высоте поля с ограничением ширины и применяет RightIconScale. По умолчанию OriginalSize. FitToText не сохраняет пропорции неквадратного изображения.
SetKeepEditingOnTextSubmitvoid
public void SetKeepEditingOnTextSubmit(bool enable);Продолжать редактирование после ui_text_submit, false по умолчанию. Не отменяет TextSubmitted и не выполняет проверку значения.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableПродолжать редактирование после ui_text_submit, false по умолчанию. Не отменяет TextSubmitted и не выполняет проверку значения.
SetLanguagevoid
public void SetLanguage(string language);Язык shaping, пустой по умолчанию использует локаль элемента. Не переводит Text и не переключает локаль приложения; задавайте код языка для корректного формирования письма.
| Имя | Тип | По умолчанию |
|---|---|---|
language | string | — |
languageЯзык shaping, пустой по умолчанию использует локаль элемента. Не переводит Text и не переключает локаль приложения; задавайте код языка для корректного формирования письма.
SetMaxLengthvoid
public void SetMaxLength(int chars);Максимум Unicode-кодовых точек, 0 означает без ограничения. Требуется число ≥ 0. Setter повторно применяет текущий текст, может обрезать хвост и сбрасывает курсор/выделение; TextChanged не испускается.
| Имя | Тип | По умолчанию |
|---|---|---|
chars | int | — |
charsМаксимум Unicode-кодовых точек, 0 означает без ограничения. Требуется число ≥ 0. Setter повторно применяет текущий текст, может обрезать хвост и сбрасывает курсор/выделение; TextChanged не испускается.
SetMiddleMousePasteEnabledvoid
public void SetMiddleMousePasteEnabled(bool enable);Разрешает вставку primary selection средней кнопкой на поддерживаемой платформе, true по умолчанию. Отдельно от обычной вставки из clipboard; при false программные вставки остаются доступны.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableРазрешает вставку primary selection средней кнопкой на поддерживаемой платформе, true по умолчанию. Отдельно от обычной вставки из clipboard; при false программные вставки остаются доступны.
SetPlaceholdervoid
public void SetPlaceholder(string text);Отдельная подсказка для пустого поля, пустая по умолчанию. Не входит в Text и не считается введённым значением; отображение использует перевод подсказки.
| Имя | Тип | По умолчанию |
|---|---|---|
text | string | — |
textОтдельная подсказка для пустого поля, пустая по умолчанию. Не входит в Text и не считается введённым значением; отображение использует перевод подсказки.
SetRightIconvoid
public void SetRightIcon(Texture2D icon);Общая Texture2D справа, null по умолчанию. В режиме RTL размещение зеркалится. Встроенная кнопка очистки имеет приоритет, когда видима. Изменения назначенной текстуры обновляют минимум; ресурс не копируется.
| Имя | Тип | По умолчанию |
|---|---|---|
icon | Texture2D | — |
iconОбщая Texture2D справа, null по умолчанию. В режиме RTL размещение зеркалится. Встроенная кнопка очистки имеет приоритет, когда видима. Изменения назначенной текстуры обновляют минимум; ресурс не копируется.
SetRightIconScalevoid
public void SetRightIconScale(float scale);Множитель размера иконки только при IconExpandMode = FitToLineEdit, 1 по умолчанию. Другие режимы его игнорируют. Setter не ограничивает диапазон: используйте положительное конечное число, обычно 0.1–1.
| Имя | Тип | По умолчанию |
|---|---|---|
scale | float | — |
scaleМножитель размера иконки только при IconExpandMode = FitToLineEdit, 1 по умолчанию. Другие режимы его игнорируют. Setter не ограничивает диапазон: используйте положительное конечное число, обычно 0.1–1.
SetSecretvoid
public void SetSecret(bool enabled);Маскирует отображение, false по умолчанию. Text и GetSelectedText сохраняют исходные символы; это не шифрование или безопасное хранение пароля.
| Имя | Тип | По умолчанию |
|---|---|---|
enabled | bool | — |
enabledМаскирует отображение, false по умолчанию. Text и GetSelectedText сохраняют исходные символы; это не шифрование или безопасное хранение пароля.
SetSecretCharactervoid
public void SetSecretCharacter(string character);Символ маски, • по умолчанию. Задавайте одну Unicode-кодовую точку: более длинная строка вызывает предупреждение и обрезается. Пустое значение рисуется стандартным •, не очищая Text.
| Имя | Тип | По умолчанию |
|---|---|---|
character | string | — |
characterСимвол маски, • по умолчанию. Задавайте одну Unicode-кодовую точку: более длинная строка вызывает предупреждение и обрезается. Пустое значение рисуется стандартным •, не очищая Text.
SetSelectAllOnFocusvoid
public void SetSelectAllOnFocus(bool enabled);Выделять весь текст при начале редактирования, false по умолчанию. При зажатой левой кнопке мыши выделение откладывается до отпускания. Не отменяет SelectingEnabled = false.
| Имя | Тип | По умолчанию |
|---|---|---|
enabled | bool | — |
enabledВыделять весь текст при начале редактирования, false по умолчанию. При зажатой левой кнопке мыши выделение откладывается до отпускания. Не отменяет SelectingEnabled = false.
SetSelectingEnabledvoid
public void SetSelectingEnabled(bool enable);Разрешает выделение, true по умолчанию. Выключение снимает выделение; Select и SelectAll при false ничего не делают.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableРазрешает выделение, true по умолчанию. Выключение снимает выделение; Select и SelectAll при false ничего не делают.
SetShortcutKeysEnabledvoid
public void SetShortcutKeysEnabled(bool enable);Разрешает встроенные сочетания редактирования, true по умолчанию. Не отключает обычный ввод и все навигационные действия, прямой MenuOption или программные записи Text.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableРазрешает встроенные сочетания редактирования, true по умолчанию. Не отключает обычный ввод и все навигационные действия, прямой MenuOption или программные записи Text.
SetStructuredTextBidiOverridevoid
public void SetStructuredTextBidiOverride(TextServer.StructuredTextParser parser);Правило BiDi для структурированных строк, Default по умолчанию. Uri/File/Email/List сохраняют смысл частей смешанной строки; Custom использует callback Control. Не меняет исходный Text.
| Имя | Тип | По умолчанию |
|---|---|---|
parser | TextServer.StructuredTextParser | — |
parserПравило BiDi для структурированных строк, Default по умолчанию. Uri/File/Email/List сохраняют смысл частей смешанной строки; Custom использует callback Control. Не меняет исходный Text.
SetStructuredTextBidiOverrideOptionsvoid
public void SetStructuredTextBidiOverrideOptions(Reckfell.Collections.Array args);Общий Array параметров BiDi-парсера. Getter и setter разделяют контейнер; изменение alias не запускает shaping. Для обновления создайте копию до изменения и назначьте её через setter.
| Имя | Тип | По умолчанию |
|---|---|---|
args | Reckfell.Collections.Array | — |
argsОбщий Array параметров BiDi-парсера. Getter и setter разделяют контейнер; изменение alias не запускает shaping. Для обновления создайте копию до изменения и назначьте её через setter.
SetTextvoid
public void SetText(string text);Исходное значение поля, пустое по умолчанию. Setter заменяет текст с учётом MaxLength, очищает выделение/прежнюю историю и сбрасывает курсор/прокрутку в начало. TextChanged не испускается; переполнение может испустить TextChangeRejected.
| Имя | Тип | По умолчанию |
|---|---|---|
text | string | — |
textИсходное значение поля, пустое по умолчанию. Setter заменяет текст с учётом MaxLength, очищает выделение/прежнюю историю и сбрасывает курсор/прокрутку в начало. TextChanged не испускается; переполнение может испустить TextChangeRejected.
SetTextDirectionvoid
public void SetTextDirection(Control.TextDirection direction);Направление формирования текста, Auto по умолчанию. Inherited берёт направление раскладки; Ltr/Rtl задают направление явно. Не переписывает строку в обратном порядке и не заменяет LayoutDirection.
| Имя | Тип | По умолчанию |
|---|---|---|
direction | Control.TextDirection | — |
directionНаправление формирования текста, Auto по умолчанию. Inherited берёт направление раскладки; Ltr/Rtl задают направление явно. Не переписывает строку в обратном порядке и не заменяет LayoutDirection.
SetVirtualKeyboardEnabledvoid
public void SetVirtualKeyboardEnabled(bool enable);Разрешает запросы виртуальной клавиатуры на поддерживаемой платформе, true по умолчанию. Не создаёт собственную клавиатуру и не запрещает аппаратный ввод при false.
| Имя | Тип | По умолчанию |
|---|---|---|
enable | bool | — |
enableРазрешает запросы виртуальной клавиатуры на поддерживаемой платформе, true по умолчанию. Не создаёт собственную клавиатуру и не запрещает аппаратный ввод при false.
SetVirtualKeyboardShowOnFocusvoid
public void SetVirtualKeyboardShowOnFocus(bool showOnFocus);Запрашивать виртуальную клавиатуру при получении фокуса, true по умолчанию. Нужны VirtualKeyboardEnabled и поддержка платформы. Явный Edit может запросить клавиатуру и при false.
| Имя | Тип | По умолчанию |
|---|---|---|
showOnFocus | bool | — |
showOnFocusЗапрашивать виртуальную клавиатуру при получении фокуса, true по умолчанию. Нужны VirtualKeyboardEnabled и поддержка платформы. Явный Edit может запросить клавиатуру и при false.
SetVirtualKeyboardTypevoid
public void SetVirtualKeyboardType(LineEdit.VirtualKeyboardTypeEnum type);Подсказка платформе о типе клавиатуры, Default по умолчанию. Number/EmailAddress и другие варианты не фильтруют Text и не заменяют проверку введённых данных.
| Имя | Тип | По умолчанию |
|---|---|---|
type | LineEdit.VirtualKeyboardTypeEnum | — |
typeПодсказка платформе о типе клавиатуры, Default по умолчанию. Number/EmailAddress и другие варианты не фильтруют Text и не заменяют проверку введённых данных.
Uneditvoid
public void Unedit();Завершает активное редактирование, применяет текущую IME-композицию и при необходимости скрывает виртуальную клавиатуру. Фокус не снимает и сам EditingToggled не испускает. Снятие выделения зависит от DeselectOnFocusLossEnabled и перетаскивания.
Сигналы и события4
EditingToggledСобытие
public event LineEdit.EditingToggledEventHandler EditingToggled;Уведомление из путей фокуса, пользовательских действий и изменения Editable. Не является универсальным наблюдателем IsEditing: прямые Edit/Unedit при уже имеющемся фокусе могут не испускать его. В обработчике читайте IsEditing для текущего состояния.
| Имя | Тип | По умолчанию |
|---|---|---|
toggledOn | bool | — |
toggledOnЗапрошенное состояние данного пути уведомления; фактическое читайте через IsEditing.
TextChangeRejectedСобытие
public event LineEdit.TextChangeRejectedEventHandler TextChangeRejected;Часть вставки не поместилась в MaxLength. Передаёт отброшенный хвост, а доступный префикс принимается. Возможен при SetText и изменении MaxLength, даже когда TextChanged не испускается.
| Имя | Тип | По умолчанию |
|---|---|---|
rejectedSubstring | string | — |
rejectedSubstringХвост вставки, не поместившийся в лимит кодовых точек.
TextChangedСобытие
public event LineEdit.TextChangedEventHandler TextChanged;Уведомление об изменении текста при пользовательском редактировании и некоторых программных операциях. Text/SetText и InsertTextAtCaret сами его не испускают; Clear и DeleteCharAtCaret испускают сразу, DeleteText — отложенно в дереве. Не используйте как универсальное наблюдение всех записей Text.
| Имя | Тип | По умолчанию |
|---|---|---|
newText | string | — |
newTextИсходный текст поля на момент уведомления, без маски и подсказки.
TextSubmittedСобытие
public event LineEdit.TextSubmittedEventHandler TextSubmitted;Подтверждение строки действием ui_text_submit, обычно Enter. Передаёт текущий исходный текст; присваивание Text сигнал не вызывает. Проверяйте значение по правилам приложения перед сохранением.
| Имя | Тип | По умолчанию |
|---|---|---|
newText | string | — |
newTextИсходный текст поля на момент уведомления, без маски и подсказки.
LineEdit.ExpandMode
| Значение | Описание |
|---|---|
FitToLineEdit = 2 | Измените размер правой иконки, чтобы она соответствовала размеру окна LineEdit. |
FitToText = 1 | Измените размер правой иконки так, чтобы он соответствовал размеру текста. |
OriginalSize = 0 | Для правой иконки используйте исходный размер. |
LineEdit.MenuItems
| Значение | Описание |
|---|---|
Clear = 3 | Стирает весь текст |
Copy = 1 | Копирует выделенный текст. |
Cut = 0 | Вырезает (копирует и очищает) выделенный текст. |
DirAuto = 9 | Устанавливает автоматическое направление текста. |
DirInherited = 8 | Устанавливает унаследованное направление текста. |
DirLtr = 10 | Устанавливает направление текста слева направо. |
DirRtl = 11 | Устанавливает направление текста справа налево. |
DisplayUcc = 12 | Переключает отображение управляющего символа. |
EmojiAndSymbol = 30 | Открывает системный выбор эмодзи и символов. |
InsertAlm = 21 | Вставляет символ арабской буквы (ALM). |
InsertFsi = 24 | Вставляет первый сильный изолятный (FSI) символ. |
InsertLre = 16 | Вставляет начало символа вставки слева направо (LRE). |
InsertLri = 22 | Вставляет изолирующий символ слева направо (LRI). |
InsertLrm = 14 | Вставляет символ знака слева направо (LRM). |
InsertLro = 18 | Вставляет начало символа переопределения слева направо (LRO). |
InsertPdf = 20 | Вставляет символ форматирования направления поп-арта (PDF). |
InsertPdi = 25 | Вставляет символ изоляции направления поп-музыки (PDI). |
InsertRle = 17 | Вставляет начало символа вставки справа налево (RLE). |
InsertRli = 23 | Вставляет изолирующий символ справа налево (RLI). |
InsertRlm = 15 | Вставляет символ с письмом справа налево (RLM). |
InsertRlo = 19 | Вставляет начало символа переопределения справа налево (RLO). |
InsertShy = 29 | Вставляет символ мягкого дефиса (SHY). |
InsertWj = 28 | Вставляет символ объединения слов (WJ). |
InsertZwj = 26 | Вставляет символ объединения нулевой ширины (ZWJ). |
InsertZwnj = 27 | Вставляет символ нулевой ширины, не являющийся объединяющим (ZWNJ). |
Max = 31 | Представляет размер перечисления
|
Paste = 2 | Вставить текст буфера обмена на выбранный текст (или в позиции eldet).
Непечатанные символы эвакуации автоматически удаляются из OS буфер обмена через |
Redo = 6 | Отменить последнее отмененное действие. |
SelectAll = 4 | Выделяет весь текст |
SubmenuInsertUcc = 13 | Идентификатор "Включить" Control Символ" субмену. |
SubmenuTextDir = 7 | Идентификатор подменю «Направление написания текста». |
Undo = 5 | Отменяет предыдущее действие. |
LineEdit.VirtualKeyboardTypeEnum
| Значение | Описание |
|---|---|
Default = 0 | Текстовая виртуальная клавиатура по умолчанию.
|
EmailAddress = 5 | Виртуальная клавиатура с дополнительными клавишами для облегчения ввода адресов электронной почты. |
Multiline = 1 | Многострочная виртуальная клавиатура. |
Number = 2 | Виртуальная цифровая клавиатура, полезная для ввода ПИН-кода. |
NumberDecimal = 3 | Виртуальная цифровая клавиатура, полезная для ввода дробных чисел. |
Password = 6 | Виртуальная клавиатура для ввода пароля. На большинстве платформ это должно отключить автозаполнение и автоматическую капитализацию.
Примечание: Это не поддерживается в Web. Вместо этого это ведет себя идентично |
Phone = 4 | Виртуальная клавиатура для набора номера телефона.
|
Url = 7 | Виртуальная клавиатура с дополнительными клавишами для облегчения ввода URL-адресов. |
Свойства темы
Это ключи ресурсов Theme, а не свойства C# класса. Используйте методы GetTheme…() и AddTheme…Override() у Control с соответствующим типом значения.
| Ключ и тип | Описание |
|---|---|
caret_colorColor | Color ЗАПЛАНИРОВАННЫЕ ЗАСЕДАНИЯ Color(0.95, 0.95, 0.95, 1) |
clear_button_colorColor | Color Используется как по умолчанию для прозрачной кнопки. По умолчанию:Color(0.875, 0.875, 0.875, 1) |
clear_button_color_pressedColor | Color используется для прозрачной кнопки при нажатии. По умолчанию:Color(1, 1, 1, 1) |
font_colorColor | Цвет шрифта по умолч. По умолчанию:Color(0.875, 0.875, 0.875, 1) |
font_outline_colorColor | Оттенок контура текста Color(0, 0, 0, 1) |
font_placeholder_colorColor | Font цвет для Color(0.875, 0.875, 0.875, 0.6) |
font_selected_colorColor | Font Цвет выбранного текста (внутри прямоугольника). По умолчанию:Color(1, 1, 1, 1) |
font_uneditable_colorColor | Font цвет при отключении редактирования. По умолчанию:Color(0.875, 0.875, 0.875, 0.5) |
selection_colorColor | Color прямоугольника отбора. По умолчанию:Color(0.5, 0.5, 0.5, 1) |
caret_widthint | Ширина каретки в пикселях. Большие значения можно использовать для улучшения доступности, обеспечивая легкую видимость каретки или для обеспечения согласованности с большим размером шрифта. По умолчанию:1 |
minimum_character_widthint | Минимальное горизонтальное пространство для текста (не считая четкой кнопки и поля содержания). Это значение измеряется по количеству символов "W" (т.е. это число символов "W" может быть показано без прокручивания). По умолчанию:4 |
outline_sizeint | Размер контура текста.
Примечание: При использовании шрифта с включенным 0 |
fontFont | Font используется для текста. |
font_sizeint | Font размер |
clearTexture2D | Texture для прозрачной кнопки. |
caret_move_rejected_soundAudioStream | Играли, когда попробовали переместить лечебницу с помощью стрелок, [КБд] Дом[/kbd], [kbd]В конце[/kbd], [КБд.[/kbd], или [КБд вниз[/kBd], но ласка не двигается, так как она уже в начале/концах текста. |
caret_moved_soundAudioStream | Играл, когда хитрость перемещалась с помощью стрелочных клавиш, [КБд] Дом[/kbd], [kbd]В конце[/kbd], [КБд.[/kbd], [КБд вниз[/kbd], или мышиные щелчки. Сосредоточься. |
focus_soundAudioStream | Играл, когда это |
text_change_rejected_soundAudioStream | Воспроизведено, когда изменение текста отклоняется (например, при нажатии заднего пространства в отсутствие текста или когда |
text_changed_soundAudioStream | Воспроизводится при успешном изменении текста с помощью ввода клавиатуры (физического или виртуального). |
text_submitted_soundAudioStream | Воспроизводится при представлении текста с использованием Сосредоточься |
focusStyleBox | Фон используется, когда |
normalStyleBox | Фон по умолчанию для |
read_onlyStyleBox | Фон используется, когда |