reckfellENGINE

LineEdit

Однострочное поле с выделением, ограничением длины и отдельными сигналами изменения/подтверждения.

На этой странице
class LineEditReckfellSharpНаследует Control

Используйте 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Конструктор
# LineEdit
C#
public LineEdit();

Создаёт пустое редактируемое поле: MaxLength = 0, курсор 0, выделение разрешено, Secret выключен.

Свойства36

AlignmentСвойство
# Alignment
C#
public HorizontalAlignment Alignment { get; set; }

Горизонтальное выравнивание, Left по умолчанию. Left/Right учитывают направление раскладки; Fill растягивает пробелы через shaping, не переносит строку. Не задаёт CaretColumn.

BackspaceDeletesCompositeCharacterEnabledСвойство
# BackspaceDeletesCompositeCharacterEnabled
C#
public bool BackspaceDeletesCompositeCharacterEnabled { get; set; }

Удалять перед курсором составной символ целиком при CaretMidGrapheme = false; false по умолчанию означает одну кодовую точку. Влияет также на DeleteCharAtCaret.

CaretBlinkСвойство
# CaretBlink
C#
public bool CaretBlink { get; set; }

Мигание курсора, false по умолчанию. Включение использует внутреннюю обработку кадров; видимость всё равно зависит от режима редактирования, фокуса или CaretForceDisplayed.

CaretBlinkIntervalСвойство
# CaretBlinkInterval
C#
public float CaretBlinkInterval { get; set; }

Интервал переключения видимости курсора в секундах, 0.65 по умолчанию. Требуется положительное конечное число; неположительное отклоняется. Имеет эффект при CaretBlink = true.

CaretColumnСвойство
# CaretColumn
C#
public int CaretColumn { get; set; }

Позиция курсора в Unicode-кодовых точках, не индекс UTF-16; 0 по умолчанию. Setter ограничивает 0…длина текста и подстраивает прокрутку для видимости курсора в дереве.

CaretForceDisplayedСвойство
# CaretForceDisplayed
C#
public bool CaretForceDisplayed { get; set; }

Показывать курсор вне обычного условия редактирования/фокуса, false по умолчанию. Не начинает редактирование и не включает Editable. Для элемента редактируемой сцены принудительный показ не применяется.

CaretMidGraphemeСвойство
# CaretMidGrapheme
C#
public bool CaretMidGrapheme { get; set; }

Разрешает курсору перемещение внутри составного символа, false по умолчанию. При true DeleteCharAtCaret удаляет одну кодовую точку даже с включённым удалением составных символов. Прямой CaretColumn сам не выравнивает индекс на границу графемы.

ClearButtonEnabledСвойство
# ClearButtonEnabled
C#
public bool ClearButtonEnabled { get; set; }

Встроенная кнопка очистки, false по умолчанию. Рисуется у непустого редактируемого поля вместо RightIcon; её место учитывается в минимуме и при пустом поле. Очистка меняет текст, не подтверждает строку.

ContextMenuEnabledСвойство
# ContextMenuEnabled
C#
public bool ContextMenuEnabled { get; set; }

Разрешает стандартное контекстное меню по вводу пользователя, true по умолчанию. false не запрещает GetMenu, прямой MenuOption или изменение текста из кода.

DeselectOnFocusLossEnabledСвойство
# DeselectOnFocusLossEnabled
C#
public bool DeselectOnFocusLossEnabled { get; set; }

Снимать выделение при потере фокуса/завершении редактирования, true по умолчанию. Включение также сразу снимает выделение, если поле уже без фокуса. Перетаскивание имеет отдельные условия сохранения выделения.

DragAndDropSelectionEnabledСвойство
# DragAndDropSelectionEnabled
C#
public bool DragAndDropSelectionEnabled { get; set; }

Разрешает перетаскивание выделенного текста, true по умолчанию. Это отдельная политика от SelectingEnabled; не запрещает программные Select или запись Text.

DrawControlCharsСвойство
# DrawControlChars
C#
public bool DrawControlChars { get; set; }

Визуализировать управляющие символы при shaping, false по умолчанию. Не добавляет управляющие символы в Text и не меняет правила проверки ввода.

EditableСвойство
# Editable
C#
public bool Editable { get; set; }

Разрешает пользовательское редактирование, true по умолчанию. false не блокирует программные операции над текстом; при активном редактировании отключение завершает его.

EmojiMenuEnabledСвойство
# EmojiMenuEnabled
C#
public bool EmojiMenuEnabled { get; set; }

Разрешает пункт системного выбора emoji/символов в стандартном меню, true по умолчанию. Нужна поддержка платформы; false не запрещает ввод emoji или программную вставку.

ExpandToTextLengthСвойство
# ExpandToTextLength
C#
public bool ExpandToTextLength { get; set; }

Увеличивает минимальную ширину до ширины сформированного текста с местом для курсора, false по умолчанию. Может расширить родительский контейнер; для поля фиксированной ширины оставьте false.

FlatСвойство
# Flat
C#
public bool Flat { get; set; }

Не рисовать фон normal/read_only, false по умолчанию. Отдельный focus-стиль продолжает рисоваться; поля этих стилей и минимум не исчезают.

IconExpandModeСвойство
# IconExpandMode
C#
public LineEdit.ExpandMode IconExpandMode { get; set; }

Размер RightIcon и иконки очистки: OriginalSize использует исходные размеры; FitToText делает квадрат высотой шрифта; FitToLineEdit вписывает по высоте поля с ограничением ширины и применяет RightIconScale. По умолчанию OriginalSize. FitToText не сохраняет пропорции неквадратного изображения.

KeepEditingOnTextSubmitСвойство
# KeepEditingOnTextSubmit
C#
public bool KeepEditingOnTextSubmit { get; set; }

Продолжать редактирование после ui_text_submit, false по умолчанию. Не отменяет TextSubmitted и не выполняет проверку значения.

LanguageСвойство
# Language
C#
public string Language { get; set; }

Язык shaping, пустой по умолчанию использует локаль элемента. Не переводит Text и не переключает локаль приложения; задавайте код языка для корректного формирования письма.

MaxLengthСвойство
# MaxLength
C#
public int MaxLength { get; set; }

Максимум Unicode-кодовых точек, 0 означает без ограничения. Требуется число ≥ 0. Setter повторно применяет текущий текст, может обрезать хвост и сбрасывает курсор/выделение; TextChanged не испускается.

MiddleMousePasteEnabledСвойство
# MiddleMousePasteEnabled
C#
public bool MiddleMousePasteEnabled { get; set; }

Разрешает вставку primary selection средней кнопкой на поддерживаемой платформе, true по умолчанию. Отдельно от обычной вставки из clipboard; при false программные вставки остаются доступны.

PlaceholderTextСвойство
# PlaceholderText
C#
public string PlaceholderText { get; set; }

Отдельная подсказка для пустого поля, пустая по умолчанию. Не входит в Text и не считается введённым значением; отображение использует перевод подсказки.

RightIconСвойство
# RightIcon
C#
public Texture2D RightIcon { get; set; }

Общая Texture2D справа, null по умолчанию. В режиме RTL размещение зеркалится. Встроенная кнопка очистки имеет приоритет, когда видима. Изменения назначенной текстуры обновляют минимум; ресурс не копируется.

RightIconScaleСвойство
# RightIconScale
C#
public float RightIconScale { get; set; }

Множитель размера иконки только при IconExpandMode = FitToLineEdit, 1 по умолчанию. Другие режимы его игнорируют. Setter не ограничивает диапазон: используйте положительное конечное число, обычно 0.1–1.

SecretСвойство
# Secret
C#
public bool Secret { get; set; }

Маскирует отображение, false по умолчанию. Text и GetSelectedText сохраняют исходные символы; это не шифрование или безопасное хранение пароля.

SecretCharacterСвойство
# SecretCharacter
C#
public string SecretCharacter { get; set; }

Символ маски, • по умолчанию. Задавайте одну Unicode-кодовую точку: более длинная строка вызывает предупреждение и обрезается. Пустое значение рисуется стандартным •, не очищая Text.

SelectAllOnFocusСвойство
# SelectAllOnFocus
C#
public bool SelectAllOnFocus { get; set; }

Выделять весь текст при начале редактирования, false по умолчанию. При зажатой левой кнопке мыши выделение откладывается до отпускания. Не отменяет SelectingEnabled = false.

SelectingEnabledСвойство
# SelectingEnabled
C#
public bool SelectingEnabled { get; set; }

Разрешает выделение, true по умолчанию. Выключение снимает выделение; Select и SelectAll при false ничего не делают.

ShortcutKeysEnabledСвойство
# ShortcutKeysEnabled
C#
public bool ShortcutKeysEnabled { get; set; }

Разрешает встроенные сочетания редактирования, true по умолчанию. Не отключает обычный ввод и все навигационные действия, прямой MenuOption или программные записи Text.

StructuredTextBidiOverrideСвойство
# StructuredTextBidiOverride
C#
public TextServer.StructuredTextParser StructuredTextBidiOverride { get; set; }

Правило BiDi для структурированных строк, Default по умолчанию. Uri/File/Email/List сохраняют смысл частей смешанной строки; Custom использует callback Control. Не меняет исходный Text.

StructuredTextBidiOverrideOptionsСвойство
# StructuredTextBidiOverrideOptions
C#
public Reckfell.Collections.Array StructuredTextBidiOverrideOptions { get; set; }

Общий Array параметров BiDi-парсера. Getter и setter разделяют контейнер; изменение alias не запускает shaping. Для обновления создайте копию до изменения и назначьте её через setter.

TextСвойство
# Text
C#
public string Text { get; set; }

Исходное значение поля, пустое по умолчанию. Setter заменяет текст с учётом MaxLength, очищает выделение/прежнюю историю и сбрасывает курсор/прокрутку в начало. TextChanged не испускается; переполнение может испустить TextChangeRejected.

TextDirectionСвойство
# TextDirection
C#
public Control.TextDirection TextDirection { get; set; }

Направление формирования текста, Auto по умолчанию. Inherited берёт направление раскладки; Ltr/Rtl задают направление явно. Не переписывает строку в обратном порядке и не заменяет LayoutDirection.

VirtualKeyboardEnabledСвойство
# VirtualKeyboardEnabled
C#
public bool VirtualKeyboardEnabled { get; set; }

Разрешает запросы виртуальной клавиатуры на поддерживаемой платформе, true по умолчанию. Не создаёт собственную клавиатуру и не запрещает аппаратный ввод при false.

VirtualKeyboardShowOnFocusСвойство
# VirtualKeyboardShowOnFocus
C#
public bool VirtualKeyboardShowOnFocus { get; set; }

Запрашивать виртуальную клавиатуру при получении фокуса, true по умолчанию. Нужны VirtualKeyboardEnabled и поддержка платформы. Явный Edit может запросить клавиатуру и при false.

VirtualKeyboardTypeСвойство
# VirtualKeyboardType
C#
public LineEdit.VirtualKeyboardTypeEnum VirtualKeyboardType { get; set; }

Подсказка платформе о типе клавиатуры, Default по умолчанию. Number/EmailAddress и другие варианты не фильтруют Text и не заменяют проверку введённых данных.

Методы98

ApplyImevoid
# ApplyIme
C#
public void ApplyIme();

Применяет текущую композицию через InsertTextAtCaret и закрывает IME-окно. Учитывает MaxLength, но сам не испускает TextChanged и не заменяет выделение как операция ввода. Без композиции только закрывает IME-окно при поддержке платформы.

CancelImevoid
# CancelIme
C#
public void CancelIme();

Отменяет незавершённую IME-композицию и закрывает IME-окно, не вставляя её в Text. Не отменяет уже подтверждённый текст и не является Undo.

Clearvoid
# Clear
C#
public void Clear();

Очищает текст, выделение и историю, сбрасывает курсор/прокрутку. Испускает TextChanged сразу только при непустом прежнем тексте. Работает и при Editable = false.

DeleteCharAtCaretvoid
# DeleteCharAtCaret
C#
public void DeleteCharAtCaret();

Удаляет символ перед курсором и испускает TextChanged сразу. По умолчанию удаляет одну кодовую точку; при BackspaceDeletesCompositeCharacterEnabled = true и CaretMidGrapheme = false удаляет предыдущий составной символ. В начале или пустом поле ничего не делает. Не является удалением выделения.

DeleteTextvoid
# DeleteText
C#
public void DeleteText(int fromColumn, int toColumn);

Удаляет [fromColumn, toColumn) в кодовых точках; требуется 0 ≤ fromColumn ≤ toColumn ≤ длина. Текст/курсор меняются сразу, TextChanged в дереве планируется отложенно, несколько удалений до вызова объединяются. Метод не снимает выделение автоматически; управляйте им отдельно.

Параметры
ИмяТипПо умолчанию
fromColumnint—
toColumnint—
fromColumn

Начало полуинтервала в Unicode-кодовых точках; для DeleteText требуется допустимый индекс.

toColumn

Исключённый конец в кодовых точках. Только Select принимает отрицательное значение как конец строки.

Deselectvoid
# Deselect
C#
public void Deselect();

Снимает выделение и сбрасывает его границы, не меняя текст или позицию курсора.

Edit2 перегрузки
# Edit · 1/2
C#
public void Edit();

Начинает редактирование в дереве; при необходимости сначала запрашивает фокус. Требует Editable. hideFocus скрывает индикацию запрошенного фокуса, не сам ввод. При уже имеющемся фокусе прямой Edit меняет состояние без EditingToggled; при получении фокуса сигнал может прийти по пути FocusEnter. Явный Edit запрашивает виртуальную клавиатуру независимо от VirtualKeyboardShowOnFocus, но учитывает VirtualKeyboardEnabled и поддержку платформы.

# Edit · 2/2
C#
public void Edit(bool hideFocus = false);

Начинает редактирование в дереве; при необходимости сначала запрашивает фокус. Требует Editable. hideFocus скрывает индикацию запрошенного фокуса, не сам ввод. При уже имеющемся фокусе прямой Edit меняет состояние без EditingToggled; при получении фокуса сигнал может прийти по пути FocusEnter. Явный Edit запрашивает виртуальную клавиатуру независимо от VirtualKeyboardShowOnFocus, но учитывает VirtualKeyboardEnabled и поддержку платформы.

Параметры
ИмяТипПо умолчанию
hideFocusboolfalse
hideFocus

Скрыть индикацию фокуса при его получении через Edit.

GetCaretBlinkIntervalfloat
# GetCaretBlinkInterval
C#
public float GetCaretBlinkInterval();

Интервал переключения видимости курсора в секундах, 0.65 по умолчанию. Требуется положительное конечное число; неположительное отклоняется. Имеет эффект при CaretBlink = true.

Возвращает float

Интервал переключения в секундах.

GetCaretColumnint
# GetCaretColumn
C#
public int GetCaretColumn();

Позиция курсора в Unicode-кодовых точках, не индекс UTF-16; 0 по умолчанию. Setter ограничивает 0…длина текста и подстраивает прокрутку для видимости курсора в дереве.

Возвращает int

Текущая колонка курсора в кодовых точках.

GetDrawControlCharsbool
# GetDrawControlChars
C#
public bool GetDrawControlChars();

Визуализировать управляющие символы при shaping, false по умолчанию. Не добавляет управляющие символы в Text и не меняет правила проверки ввода.

Возвращает bool

Флаг визуализации управляющих символов.

GetHorizontalAlignmentHorizontalAlignment
# GetHorizontalAlignment
C#
public HorizontalAlignment GetHorizontalAlignment();

Горизонтальное выравнивание, Left по умолчанию. Left/Right учитывают направление раскладки; Fill растягивает пробелы через shaping, не переносит строку. Не задаёт CaretColumn.

Возвращает HorizontalAlignment

Текущий HorizontalAlignment.

GetIconExpandModeLineEdit.ExpandMode
# GetIconExpandMode
C#
public LineEdit.ExpandMode GetIconExpandMode();

Размер RightIcon и иконки очистки: OriginalSize использует исходные размеры; FitToText делает квадрат высотой шрифта; FitToLineEdit вписывает по высоте поля с ограничением ширины и применяет RightIconScale. По умолчанию OriginalSize. FitToText не сохраняет пропорции неквадратного изображения.

Возвращает LineEdit.ExpandMode

Текущий LineEdit.ExpandMode.

GetLanguagestring
# GetLanguage
C#
public string GetLanguage();

Язык shaping, пустой по умолчанию использует локаль элемента. Не переводит Text и не переключает локаль приложения; задавайте код языка для корректного формирования письма.

Возвращает string

Язык shaping либо пустая строка для локали элемента.

GetMaxLengthint
# GetMaxLength
C#
public int GetMaxLength();

Максимум Unicode-кодовых точек, 0 означает без ограничения. Требуется число ≥ 0. Setter повторно применяет текущий текст, может обрезать хвост и сбрасывает курсор/выделение; TextChanged не испускается.

Возвращает int

Лимит кодовых точек; 0 означает без ограничения.

GetMenuPopupMenu
# GetMenu
C#
public PopupMenu GetMenu();

Лениво создаёт и возвращает внутренний PopupMenu, принадлежащий LineEdit. Не освобождайте и не удаляйте его. GetMenu работает и при ContextMenuEnabled = false; сам меню не открывает. Встроенные пункты обновляются перед показом; сохраняйте их ID и не подменяйте обработчик встроенных команд.

Возвращает PopupMenu

Общий внутренний PopupMenu, принадлежащий полю.

GetNextCompositeCharacterColumnint
# GetNextCompositeCharacterColumn
C#
public int GetNextCompositeCharacterColumn(int column);

Возвращает позицию после составного символа по результату shaping. Требуется колонка 0…длина в кодовых точках; в конце возвращает ту же позицию.

Параметры
ИмяТипПо умолчанию
columnint—
column

Текущая позиция в кодовых точках: 0…длина Text, не индекс UTF-16.

Возвращает int

Следующая граница составного символа в кодовых точках; в конце текущая позиция.

GetPlaceholderstring
# GetPlaceholder
C#
public string GetPlaceholder();

Отдельная подсказка для пустого поля, пустая по умолчанию. Не входит в Text и не считается введённым значением; отображение использует перевод подсказки.

Возвращает string

Исходная строка подсказки, не введённое значение.

GetPreviousCompositeCharacterColumnint
# GetPreviousCompositeCharacterColumn
C#
public int GetPreviousCompositeCharacterColumn(int column);

Возвращает позицию перед составным символом по результату shaping. Требуется колонка 0…длина в кодовых точках; в начале возвращает 0.

Параметры
ИмяТипПо умолчанию
columnint—
column

Текущая позиция в кодовых точках: 0…длина Text, не индекс UTF-16.

Возвращает int

Предыдущая граница составного символа в кодовых точках; в начале 0.

GetRightIconTexture2D
# GetRightIcon
C#
public Texture2D GetRightIcon();

Общая Texture2D справа, null по умолчанию. В режиме RTL размещение зеркалится. Встроенная кнопка очистки имеет приоритет, когда видима. Изменения назначенной текстуры обновляют минимум; ресурс не копируется.

Возвращает Texture2D

Общая Texture2D либо null.

GetRightIconScalefloat
# GetRightIconScale
C#
public float GetRightIconScale();

Множитель размера иконки только при IconExpandMode = FitToLineEdit, 1 по умолчанию. Другие режимы его игнорируют. Setter не ограничивает диапазон: используйте положительное конечное число, обычно 0.1–1.

Возвращает float

Сохранённый множитель размера FitToLineEdit.

GetScrollOffsetfloat
# GetScrollOffset
C#
public float GetScrollOffset();

Возвращает горизонтальный сдвиг рисования текста в локальных пикселях, обычно ≤ 0. Это не индекс символа и не положительная позиция ScrollBar; меняется при подстройке видимости курсора.

Возвращает float

Сдвиг рисования текста в локальных пикселях.

GetSecretCharacterstring
# GetSecretCharacter
C#
public string GetSecretCharacter();

Символ маски, • по умолчанию. Задавайте одну Unicode-кодовую точку: более длинная строка вызывает предупреждение и обрезается. Пустое значение рисуется стандартным •, не очищая Text.

Возвращает string

Сохранённый символ маски либо пустая строка.

GetSelectedTextstring
# GetSelectedText
C#
public string GetSelectedText();

Возвращает выделенный фрагмент исходного Text, даже в Secret-режиме; без выделения — пустую строку.

Возвращает string

Выделенный исходный текст либо пустая строка.

GetSelectionFromColumnint
# GetSelectionFromColumn
C#
public int GetSelectionFromColumn();

Возвращает начало выделения в кодовых точках. Сначала проверьте HasSelection: без выделения метод сообщает ошибку и возвращает -1.

Возвращает int

Начальная включённая колонка; без выделения -1 с ошибкой.

GetSelectionToColumnint
# GetSelectionToColumn
C#
public int GetSelectionToColumn();

Возвращает исключённый конец выделения в кодовых точках. Сначала проверьте HasSelection: без выделения сообщает ошибку и возвращает -1.

Возвращает int

Конечная исключённая колонка; без выделения -1 с ошибкой.

GetStructuredTextBidiOverrideTextServer.StructuredTextParser
# GetStructuredTextBidiOverride
C#
public TextServer.StructuredTextParser GetStructuredTextBidiOverride();

Правило BiDi для структурированных строк, Default по умолчанию. Uri/File/Email/List сохраняют смысл частей смешанной строки; Custom использует callback Control. Не меняет исходный Text.

Возвращает TextServer.StructuredTextParser

Выбранный TextServer.StructuredTextParser.

GetStructuredTextBidiOverrideOptionsReckfell.Collections.Array
# GetStructuredTextBidiOverrideOptions
C#
public Reckfell.Collections.Array GetStructuredTextBidiOverrideOptions();

Общий Array параметров BiDi-парсера. Getter и setter разделяют контейнер; изменение alias не запускает shaping. Для обновления создайте копию до изменения и назначьте её через setter.

Возвращает Reckfell.Collections.Array

Array параметров с общим содержимым.

GetTextstring
# GetText
C#
public string GetText();

Исходное значение поля, пустое по умолчанию. Setter заменяет текст с учётом MaxLength, очищает выделение/прежнюю историю и сбрасывает курсор/прокрутку в начало. TextChanged не испускается; переполнение может испустить TextChangeRejected.

Возвращает string

Исходный текст поля без маски и подсказки.

GetTextDirectionControl.TextDirection
# GetTextDirection
C#
public Control.TextDirection GetTextDirection();

Направление формирования текста, Auto по умолчанию. Inherited берёт направление раскладки; Ltr/Rtl задают направление явно. Не переписывает строку в обратном порядке и не заменяет LayoutDirection.

Возвращает Control.TextDirection

Выбранный Control.TextDirection.

GetVirtualKeyboardShowOnFocusbool
# GetVirtualKeyboardShowOnFocus
C#
public bool GetVirtualKeyboardShowOnFocus();

Запрашивать виртуальную клавиатуру при получении фокуса, true по умолчанию. Нужны VirtualKeyboardEnabled и поддержка платформы. Явный Edit может запросить клавиатуру и при false.

Возвращает bool

Флаг запроса клавиатуры при фокусе.

GetVirtualKeyboardTypeLineEdit.VirtualKeyboardTypeEnum
# GetVirtualKeyboardType
C#
public LineEdit.VirtualKeyboardTypeEnum GetVirtualKeyboardType();

Подсказка платформе о типе клавиатуры, Default по умолчанию. Number/EmailAddress и другие варианты не фильтруют Text и не заменяют проверку введённых данных.

Возвращает LineEdit.VirtualKeyboardTypeEnum

Подсказка LineEdit.VirtualKeyboardTypeEnum.

HasImeTextbool
# HasImeText
C#
public bool HasImeText();

Есть ли незавершённая IME-композиция. Она отображается отдельно от подтверждённого Text; false не означает, что платформа вообще не поддерживает IME.

Возвращает bool

true при незавершённой композиции.

HasRedobool
# HasRedo
C#
public bool HasRedo();

Есть ли следующее состояние после отмены. Новое редактирование может сбросить эту ветку; Editable = false отдельно запрещает выполнение Redo.

Возвращает bool

true при доступном следующем состоянии истории.

HasSelectionbool
# HasSelection
C#
public bool HasSelection();

Проверяет активное выделение. Используйте перед чтением его границ.

Возвращает bool

true при активном выделении.

HasUndobool
# HasUndo
C#
public bool HasUndo();

Есть ли доступное предыдущее состояние в истории. Не означает, что отмена разрешена при Editable = false. Clear перестраивает историю, но предыдущее значение может оставаться доступным для отмены; не считайте очистку безопасным стиранием данных.

Возвращает bool

true при доступном предыдущем состоянии истории.

InsertTextAtCaretvoid
# InsertTextAtCaret
C#
public void InsertTextAtCaret(string text);

Вставляет текст у курсора и сдвигает его за принятый фрагмент. Учитывает MaxLength и испускает TextChangeRejected для хвоста. Сам не удаляет выделение, не проверяет Editable и не испускает TextChanged.

Параметры
ИмяТипПо умолчанию
textstring—
text

Вставляет текст у курсора и сдвигает его за принятый фрагмент. Учитывает MaxLength и испускает TextChangeRejected для хвоста. Сам не удаляет выделение, не проверяет Editable и не испускает TextChanged.

IsBackspaceDeletesCompositeCharacterEnabledbool
# IsBackspaceDeletesCompositeCharacterEnabled
C#
public bool IsBackspaceDeletesCompositeCharacterEnabled();

Удалять перед курсором составной символ целиком при CaretMidGrapheme = false; false по умолчанию означает одну кодовую точку. Влияет также на DeleteCharAtCaret.

Возвращает bool

Флаг удаления составных символов при CaretMidGrapheme = false.

IsCaretBlinkEnabledbool
# IsCaretBlinkEnabled
C#
public bool IsCaretBlinkEnabled();

Мигание курсора, false по умолчанию. Включение использует внутреннюю обработку кадров; видимость всё равно зависит от режима редактирования, фокуса или CaretForceDisplayed.

Возвращает bool

Сохранённый флаг CaretBlink.

IsCaretForceDisplayedbool
# IsCaretForceDisplayed
C#
public bool IsCaretForceDisplayed();

Показывать курсор вне обычного условия редактирования/фокуса, false по умолчанию. Не начинает редактирование и не включает Editable. Для элемента редактируемой сцены принудительный показ не применяется.

Возвращает bool

Сохранённый флаг CaretForceDisplayed.

IsCaretMidGraphemeEnabledbool
# IsCaretMidGraphemeEnabled
C#
public bool IsCaretMidGraphemeEnabled();

Разрешает курсору перемещение внутри составного символа, false по умолчанию. При true DeleteCharAtCaret удаляет одну кодовую точку даже с включённым удалением составных символов. Прямой CaretColumn сам не выравнивает индекс на границу графемы.

Возвращает bool

Разрешено ли перемещение внутри составных символов.

IsClearButtonEnabledbool
# IsClearButtonEnabled
C#
public bool IsClearButtonEnabled();

Встроенная кнопка очистки, false по умолчанию. Рисуется у непустого редактируемого поля вместо RightIcon; её место учитывается в минимуме и при пустом поле. Очистка меняет текст, не подтверждает строку.

Возвращает bool

Сохранённый флаг ClearButtonEnabled.

IsContextMenuEnabledbool
# IsContextMenuEnabled
C#
public bool IsContextMenuEnabled();

Разрешает стандартное контекстное меню по вводу пользователя, true по умолчанию. false не запрещает GetMenu, прямой MenuOption или изменение текста из кода.

Возвращает bool

Сохранённый флаг ContextMenuEnabled.

IsDeselectOnFocusLossEnabledbool
# IsDeselectOnFocusLossEnabled
C#
public bool IsDeselectOnFocusLossEnabled();

Снимать выделение при потере фокуса/завершении редактирования, true по умолчанию. Включение также сразу снимает выделение, если поле уже без фокуса. Перетаскивание имеет отдельные условия сохранения выделения.

Возвращает bool

Сохранённый флаг DeselectOnFocusLossEnabled.

IsDragAndDropSelectionEnabledbool
# IsDragAndDropSelectionEnabled
C#
public bool IsDragAndDropSelectionEnabled();

Разрешает перетаскивание выделенного текста, true по умолчанию. Это отдельная политика от SelectingEnabled; не запрещает программные Select или запись Text.

Возвращает bool

Сохранённый флаг DragAndDropSelectionEnabled.

IsEditablebool
# IsEditable
C#
public bool IsEditable();

Разрешает пользовательское редактирование, true по умолчанию. false не блокирует программные операции над текстом; при активном редактировании отключение завершает его.

Возвращает bool

Флаг разрешения пользовательского редактирования.

IsEditingbool
# IsEditing
C#
public bool IsEditing();

Возвращает режим редактирования, отдельный от Editable и HasFocus. Поле может иметь фокус после Unedit, оставаясь вне редактирования.

Возвращает bool

Текущее состояние редактирования.

IsEditingKeptOnTextSubmitbool
# IsEditingKeptOnTextSubmit
C#
public bool IsEditingKeptOnTextSubmit();

Продолжать редактирование после ui_text_submit, false по умолчанию. Не отменяет TextSubmitted и не выполняет проверку значения.

Возвращает bool

Продолжать ли редактирование после подтверждения.

IsEmojiMenuEnabledbool
# IsEmojiMenuEnabled
C#
public bool IsEmojiMenuEnabled();

Разрешает пункт системного выбора emoji/символов в стандартном меню, true по умолчанию. Нужна поддержка платформы; false не запрещает ввод emoji или программную вставку.

Возвращает bool

Сохранённый флаг EmojiMenuEnabled.

IsExpandToTextLengthEnabledbool
# IsExpandToTextLengthEnabled
C#
public bool IsExpandToTextLengthEnabled();

Увеличивает минимальную ширину до ширины сформированного текста с местом для курсора, false по умолчанию. Может расширить родительский контейнер; для поля фиксированной ширины оставьте false.

Возвращает bool

Сохранённый флаг ExpandToTextLength.

IsFlatbool
# IsFlat
C#
public bool IsFlat();

Не рисовать фон normal/read_only, false по умолчанию. Отдельный focus-стиль продолжает рисоваться; поля этих стилей и минимум не исчезают.

Возвращает bool

Сохранённый флаг Flat.

IsMenuVisiblebool
# IsMenuVisible
C#
public bool IsMenuVisible();

Возвращает видимость созданного контекстного меню; до его создания false. Сам меню не создаёт.

Возвращает bool

true, если внутреннее меню существует и видно.

IsMiddleMousePasteEnabledbool
# IsMiddleMousePasteEnabled
C#
public bool IsMiddleMousePasteEnabled();

Разрешает вставку primary selection средней кнопкой на поддерживаемой платформе, true по умолчанию. Отдельно от обычной вставки из clipboard; при false программные вставки остаются доступны.

Возвращает bool

Сохранённый флаг MiddleMousePasteEnabled.

IsSecretbool
# IsSecret
C#
public bool IsSecret();

Маскирует отображение, false по умолчанию. Text и GetSelectedText сохраняют исходные символы; это не шифрование или безопасное хранение пароля.

Возвращает bool

Флаг маскирования отображения.

IsSelectAllOnFocusbool
# IsSelectAllOnFocus
C#
public bool IsSelectAllOnFocus();

Выделять весь текст при начале редактирования, false по умолчанию. При зажатой левой кнопке мыши выделение откладывается до отпускания. Не отменяет SelectingEnabled = false.

Возвращает bool

Сохранённый флаг SelectAllOnFocus.

IsSelectingEnabledbool
# IsSelectingEnabled
C#
public bool IsSelectingEnabled();

Разрешает выделение, true по умолчанию. Выключение снимает выделение; Select и SelectAll при false ничего не делают.

Возвращает bool

Флаг разрешения выделения.

IsShortcutKeysEnabledbool
# IsShortcutKeysEnabled
C#
public bool IsShortcutKeysEnabled();

Разрешает встроенные сочетания редактирования, true по умолчанию. Не отключает обычный ввод и все навигационные действия, прямой MenuOption или программные записи Text.

Возвращает bool

Сохранённый флаг ShortcutKeysEnabled.

IsVirtualKeyboardEnabledbool
# IsVirtualKeyboardEnabled
C#
public bool IsVirtualKeyboardEnabled();

Разрешает запросы виртуальной клавиатуры на поддерживаемой платформе, true по умолчанию. Не создаёт собственную клавиатуру и не запрещает аппаратный ввод при false.

Возвращает bool

Сохранённый флаг VirtualKeyboardEnabled.

MenuOptionvoid
# MenuOption
C#
public void MenuOption(int option);

Выполняет команду по числовому значению LineEdit.MenuItems, не по индексу пункта PopupMenu. ContextMenuEnabled не блокирует этот вызов. Clear/Cut/Paste/Undo/Redo проверяют Editable; SelectAll проверяет SelectingEnabled. Clipboard/emoji-команды могут обращаться к ОС. Для собственных пунктов используйте собственный обработчик, а не произвольный MenuOption.

Параметры
ИмяТипПо умолчанию
optionint—
option

Числовое значение встроенного LineEdit.MenuItems, не индекс меню.

Selectvoid
# Select
C#
public void Select(int from = 0, int to = -1);

Выделяет [from, to) в кодовых точках, не двигая курсор. from ограничивается 0…длина; отрицательный или слишком большой to означает конец. (0, 0) снимает выделение; from ≥ to после нормализации оставляет прежнее выделение. При SelectingEnabled = false ничего не делает.

Параметры
ИмяТипПо умолчанию
fromint0
toint-1
from

Начало полуинтервала в Unicode-кодовых точках; для DeleteText требуется допустимый индекс.

to

Исключённый конец в кодовых точках. Только Select принимает отрицательное значение как конец строки.

SelectAllvoid
# SelectAll
C#
public void SelectAll();

Выделяет весь непустой текст, если SelectingEnabled включён. Не двигает курсор непустого поля; в пустом поле ставит его в 0.

SetBackspaceDeletesCompositeCharacterEnabledvoid
# SetBackspaceDeletesCompositeCharacterEnabled
C#
public void SetBackspaceDeletesCompositeCharacterEnabled(bool enable);

Удалять перед курсором составной символ целиком при CaretMidGrapheme = false; false по умолчанию означает одну кодовую точку. Влияет также на DeleteCharAtCaret.

Параметры
ИмяТипПо умолчанию
enablebool—
enable

Удалять перед курсором составной символ целиком при CaretMidGrapheme = false; false по умолчанию означает одну кодовую точку. Влияет также на DeleteCharAtCaret.

SetCaretBlinkEnabledvoid
# SetCaretBlinkEnabled
C#
public void SetCaretBlinkEnabled(bool enabled);

Мигание курсора, false по умолчанию. Включение использует внутреннюю обработку кадров; видимость всё равно зависит от режима редактирования, фокуса или CaretForceDisplayed.

Параметры
ИмяТипПо умолчанию
enabledbool—
enabled

Мигание курсора, false по умолчанию. Включение использует внутреннюю обработку кадров; видимость всё равно зависит от режима редактирования, фокуса или CaretForceDisplayed.

SetCaretBlinkIntervalvoid
# SetCaretBlinkInterval
C#
public void SetCaretBlinkInterval(float interval);

Интервал переключения видимости курсора в секундах, 0.65 по умолчанию. Требуется положительное конечное число; неположительное отклоняется. Имеет эффект при CaretBlink = true.

Параметры
ИмяТипПо умолчанию
intervalfloat—
interval

Интервал переключения видимости курсора в секундах, 0.65 по умолчанию. Требуется положительное конечное число; неположительное отклоняется. Имеет эффект при CaretBlink = true.

SetCaretColumnvoid
# SetCaretColumn
C#
public void SetCaretColumn(int position);

Позиция курсора в Unicode-кодовых точках, не индекс UTF-16; 0 по умолчанию. Setter ограничивает 0…длина текста и подстраивает прокрутку для видимости курсора в дереве.

Параметры
ИмяТипПо умолчанию
positionint—
position

Позиция курсора в Unicode-кодовых точках, не индекс UTF-16; 0 по умолчанию. Setter ограничивает 0…длина текста и подстраивает прокрутку для видимости курсора в дереве.

SetCaretForceDisplayedvoid
# SetCaretForceDisplayed
C#
public void SetCaretForceDisplayed(bool enabled);

Показывать курсор вне обычного условия редактирования/фокуса, false по умолчанию. Не начинает редактирование и не включает Editable. Для элемента редактируемой сцены принудительный показ не применяется.

Параметры
ИмяТипПо умолчанию
enabledbool—
enabled

Показывать курсор вне обычного условия редактирования/фокуса, false по умолчанию. Не начинает редактирование и не включает Editable. Для элемента редактируемой сцены принудительный показ не применяется.

SetCaretMidGraphemeEnabledvoid
# SetCaretMidGraphemeEnabled
C#
public void SetCaretMidGraphemeEnabled(bool enabled);

Разрешает курсору перемещение внутри составного символа, false по умолчанию. При true DeleteCharAtCaret удаляет одну кодовую точку даже с включённым удалением составных символов. Прямой CaretColumn сам не выравнивает индекс на границу графемы.

Параметры
ИмяТипПо умолчанию
enabledbool—
enabled

Разрешает курсору перемещение внутри составного символа, false по умолчанию. При true DeleteCharAtCaret удаляет одну кодовую точку даже с включённым удалением составных символов. Прямой CaretColumn сам не выравнивает индекс на границу графемы.

SetClearButtonEnabledvoid
# SetClearButtonEnabled
C#
public void SetClearButtonEnabled(bool enable);

Встроенная кнопка очистки, false по умолчанию. Рисуется у непустого редактируемого поля вместо RightIcon; её место учитывается в минимуме и при пустом поле. Очистка меняет текст, не подтверждает строку.

Параметры
ИмяТипПо умолчанию
enablebool—
enable

Встроенная кнопка очистки, false по умолчанию. Рисуется у непустого редактируемого поля вместо RightIcon; её место учитывается в минимуме и при пустом поле. Очистка меняет текст, не подтверждает строку.

SetContextMenuEnabledvoid
# SetContextMenuEnabled
C#
public void SetContextMenuEnabled(bool enable);

Разрешает стандартное контекстное меню по вводу пользователя, true по умолчанию. false не запрещает GetMenu, прямой MenuOption или изменение текста из кода.

Параметры
ИмяТипПо умолчанию
enablebool—
enable

Разрешает стандартное контекстное меню по вводу пользователя, true по умолчанию. false не запрещает GetMenu, прямой MenuOption или изменение текста из кода.

SetDeselectOnFocusLossEnabledvoid
# SetDeselectOnFocusLossEnabled
C#
public void SetDeselectOnFocusLossEnabled(bool enable);

Снимать выделение при потере фокуса/завершении редактирования, true по умолчанию. Включение также сразу снимает выделение, если поле уже без фокуса. Перетаскивание имеет отдельные условия сохранения выделения.

Параметры
ИмяТипПо умолчанию
enablebool—
enable

Снимать выделение при потере фокуса/завершении редактирования, true по умолчанию. Включение также сразу снимает выделение, если поле уже без фокуса. Перетаскивание имеет отдельные условия сохранения выделения.

SetDragAndDropSelectionEnabledvoid
# SetDragAndDropSelectionEnabled
C#
public void SetDragAndDropSelectionEnabled(bool enable);

Разрешает перетаскивание выделенного текста, true по умолчанию. Это отдельная политика от SelectingEnabled; не запрещает программные Select или запись Text.

Параметры
ИмяТипПо умолчанию
enablebool—
enable

Разрешает перетаскивание выделенного текста, true по умолчанию. Это отдельная политика от SelectingEnabled; не запрещает программные Select или запись Text.

SetDrawControlCharsvoid
# SetDrawControlChars
C#
public void SetDrawControlChars(bool enable);

Визуализировать управляющие символы при shaping, false по умолчанию. Не добавляет управляющие символы в Text и не меняет правила проверки ввода.

Параметры
ИмяТипПо умолчанию
enablebool—
enable

Визуализировать управляющие символы при shaping, false по умолчанию. Не добавляет управляющие символы в Text и не меняет правила проверки ввода.

SetEditablevoid
# SetEditable
C#
public void SetEditable(bool enabled);

Разрешает пользовательское редактирование, true по умолчанию. false не блокирует программные операции над текстом; при активном редактировании отключение завершает его.

Параметры
ИмяТипПо умолчанию
enabledbool—
enabled

Разрешает пользовательское редактирование, true по умолчанию. false не блокирует программные операции над текстом; при активном редактировании отключение завершает его.

SetEmojiMenuEnabledvoid
# SetEmojiMenuEnabled
C#
public void SetEmojiMenuEnabled(bool enable);

Разрешает пункт системного выбора emoji/символов в стандартном меню, true по умолчанию. Нужна поддержка платформы; false не запрещает ввод emoji или программную вставку.

Параметры
ИмяТипПо умолчанию
enablebool—
enable

Разрешает пункт системного выбора emoji/символов в стандартном меню, true по умолчанию. Нужна поддержка платформы; false не запрещает ввод emoji или программную вставку.

SetExpandToTextLengthEnabledvoid
# SetExpandToTextLengthEnabled
C#
public void SetExpandToTextLengthEnabled(bool enabled);

Увеличивает минимальную ширину до ширины сформированного текста с местом для курсора, false по умолчанию. Может расширить родительский контейнер; для поля фиксированной ширины оставьте false.

Параметры
ИмяТипПо умолчанию
enabledbool—
enabled

Увеличивает минимальную ширину до ширины сформированного текста с местом для курсора, false по умолчанию. Может расширить родительский контейнер; для поля фиксированной ширины оставьте false.

SetFlatvoid
# SetFlat
C#
public void SetFlat(bool enabled);

Не рисовать фон normal/read_only, false по умолчанию. Отдельный focus-стиль продолжает рисоваться; поля этих стилей и минимум не исчезают.

Параметры
ИмяТипПо умолчанию
enabledbool—
enabled

Не рисовать фон normal/read_only, false по умолчанию. Отдельный focus-стиль продолжает рисоваться; поля этих стилей и минимум не исчезают.

SetHorizontalAlignmentvoid
# SetHorizontalAlignment
C#
public void SetHorizontalAlignment(HorizontalAlignment alignment);

Горизонтальное выравнивание, Left по умолчанию. Left/Right учитывают направление раскладки; Fill растягивает пробелы через shaping, не переносит строку. Не задаёт CaretColumn.

Параметры
ИмяТипПо умолчанию
alignmentHorizontalAlignment—
alignment

Горизонтальное выравнивание, Left по умолчанию. Left/Right учитывают направление раскладки; Fill растягивает пробелы через shaping, не переносит строку. Не задаёт CaretColumn.

SetIconExpandModevoid
# SetIconExpandMode
C#
public void SetIconExpandMode(LineEdit.ExpandMode mode);

Размер RightIcon и иконки очистки: OriginalSize использует исходные размеры; FitToText делает квадрат высотой шрифта; FitToLineEdit вписывает по высоте поля с ограничением ширины и применяет RightIconScale. По умолчанию OriginalSize. FitToText не сохраняет пропорции неквадратного изображения.

Параметры
ИмяТипПо умолчанию
modeLineEdit.ExpandMode—
mode

Размер RightIcon и иконки очистки: OriginalSize использует исходные размеры; FitToText делает квадрат высотой шрифта; FitToLineEdit вписывает по высоте поля с ограничением ширины и применяет RightIconScale. По умолчанию OriginalSize. FitToText не сохраняет пропорции неквадратного изображения.

SetKeepEditingOnTextSubmitvoid
# SetKeepEditingOnTextSubmit
C#
public void SetKeepEditingOnTextSubmit(bool enable);

Продолжать редактирование после ui_text_submit, false по умолчанию. Не отменяет TextSubmitted и не выполняет проверку значения.

Параметры
ИмяТипПо умолчанию
enablebool—
enable

Продолжать редактирование после ui_text_submit, false по умолчанию. Не отменяет TextSubmitted и не выполняет проверку значения.

SetLanguagevoid
# SetLanguage
C#
public void SetLanguage(string language);

Язык shaping, пустой по умолчанию использует локаль элемента. Не переводит Text и не переключает локаль приложения; задавайте код языка для корректного формирования письма.

Параметры
ИмяТипПо умолчанию
languagestring—
language

Язык shaping, пустой по умолчанию использует локаль элемента. Не переводит Text и не переключает локаль приложения; задавайте код языка для корректного формирования письма.

SetMaxLengthvoid
# SetMaxLength
C#
public void SetMaxLength(int chars);

Максимум Unicode-кодовых точек, 0 означает без ограничения. Требуется число ≥ 0. Setter повторно применяет текущий текст, может обрезать хвост и сбрасывает курсор/выделение; TextChanged не испускается.

Параметры
ИмяТипПо умолчанию
charsint—
chars

Максимум Unicode-кодовых точек, 0 означает без ограничения. Требуется число ≥ 0. Setter повторно применяет текущий текст, может обрезать хвост и сбрасывает курсор/выделение; TextChanged не испускается.

SetMiddleMousePasteEnabledvoid
# SetMiddleMousePasteEnabled
C#
public void SetMiddleMousePasteEnabled(bool enable);

Разрешает вставку primary selection средней кнопкой на поддерживаемой платформе, true по умолчанию. Отдельно от обычной вставки из clipboard; при false программные вставки остаются доступны.

Параметры
ИмяТипПо умолчанию
enablebool—
enable

Разрешает вставку primary selection средней кнопкой на поддерживаемой платформе, true по умолчанию. Отдельно от обычной вставки из clipboard; при false программные вставки остаются доступны.

SetPlaceholdervoid
# SetPlaceholder
C#
public void SetPlaceholder(string text);

Отдельная подсказка для пустого поля, пустая по умолчанию. Не входит в Text и не считается введённым значением; отображение использует перевод подсказки.

Параметры
ИмяТипПо умолчанию
textstring—
text

Отдельная подсказка для пустого поля, пустая по умолчанию. Не входит в Text и не считается введённым значением; отображение использует перевод подсказки.

SetRightIconvoid
# SetRightIcon
C#
public void SetRightIcon(Texture2D icon);

Общая Texture2D справа, null по умолчанию. В режиме RTL размещение зеркалится. Встроенная кнопка очистки имеет приоритет, когда видима. Изменения назначенной текстуры обновляют минимум; ресурс не копируется.

Параметры
ИмяТипПо умолчанию
iconTexture2D—
icon

Общая Texture2D справа, null по умолчанию. В режиме RTL размещение зеркалится. Встроенная кнопка очистки имеет приоритет, когда видима. Изменения назначенной текстуры обновляют минимум; ресурс не копируется.

SetRightIconScalevoid
# SetRightIconScale
C#
public void SetRightIconScale(float scale);

Множитель размера иконки только при IconExpandMode = FitToLineEdit, 1 по умолчанию. Другие режимы его игнорируют. Setter не ограничивает диапазон: используйте положительное конечное число, обычно 0.1–1.

Параметры
ИмяТипПо умолчанию
scalefloat—
scale

Множитель размера иконки только при IconExpandMode = FitToLineEdit, 1 по умолчанию. Другие режимы его игнорируют. Setter не ограничивает диапазон: используйте положительное конечное число, обычно 0.1–1.

SetSecretvoid
# SetSecret
C#
public void SetSecret(bool enabled);

Маскирует отображение, false по умолчанию. Text и GetSelectedText сохраняют исходные символы; это не шифрование или безопасное хранение пароля.

Параметры
ИмяТипПо умолчанию
enabledbool—
enabled

Маскирует отображение, false по умолчанию. Text и GetSelectedText сохраняют исходные символы; это не шифрование или безопасное хранение пароля.

SetSecretCharactervoid
# SetSecretCharacter
C#
public void SetSecretCharacter(string character);

Символ маски, • по умолчанию. Задавайте одну Unicode-кодовую точку: более длинная строка вызывает предупреждение и обрезается. Пустое значение рисуется стандартным •, не очищая Text.

Параметры
ИмяТипПо умолчанию
characterstring—
character

Символ маски, • по умолчанию. Задавайте одну Unicode-кодовую точку: более длинная строка вызывает предупреждение и обрезается. Пустое значение рисуется стандартным •, не очищая Text.

SetSelectAllOnFocusvoid
# SetSelectAllOnFocus
C#
public void SetSelectAllOnFocus(bool enabled);

Выделять весь текст при начале редактирования, false по умолчанию. При зажатой левой кнопке мыши выделение откладывается до отпускания. Не отменяет SelectingEnabled = false.

Параметры
ИмяТипПо умолчанию
enabledbool—
enabled

Выделять весь текст при начале редактирования, false по умолчанию. При зажатой левой кнопке мыши выделение откладывается до отпускания. Не отменяет SelectingEnabled = false.

SetSelectingEnabledvoid
# SetSelectingEnabled
C#
public void SetSelectingEnabled(bool enable);

Разрешает выделение, true по умолчанию. Выключение снимает выделение; Select и SelectAll при false ничего не делают.

Параметры
ИмяТипПо умолчанию
enablebool—
enable

Разрешает выделение, true по умолчанию. Выключение снимает выделение; Select и SelectAll при false ничего не делают.

SetShortcutKeysEnabledvoid
# SetShortcutKeysEnabled
C#
public void SetShortcutKeysEnabled(bool enable);

Разрешает встроенные сочетания редактирования, true по умолчанию. Не отключает обычный ввод и все навигационные действия, прямой MenuOption или программные записи Text.

Параметры
ИмяТипПо умолчанию
enablebool—
enable

Разрешает встроенные сочетания редактирования, true по умолчанию. Не отключает обычный ввод и все навигационные действия, прямой MenuOption или программные записи Text.

SetStructuredTextBidiOverridevoid
# SetStructuredTextBidiOverride
C#
public void SetStructuredTextBidiOverride(TextServer.StructuredTextParser parser);

Правило BiDi для структурированных строк, Default по умолчанию. Uri/File/Email/List сохраняют смысл частей смешанной строки; Custom использует callback Control. Не меняет исходный Text.

Параметры
ИмяТипПо умолчанию
parserTextServer.StructuredTextParser—
parser

Правило BiDi для структурированных строк, Default по умолчанию. Uri/File/Email/List сохраняют смысл частей смешанной строки; Custom использует callback Control. Не меняет исходный Text.

SetStructuredTextBidiOverrideOptionsvoid
# SetStructuredTextBidiOverrideOptions
C#
public void SetStructuredTextBidiOverrideOptions(Reckfell.Collections.Array args);

Общий Array параметров BiDi-парсера. Getter и setter разделяют контейнер; изменение alias не запускает shaping. Для обновления создайте копию до изменения и назначьте её через setter.

Параметры
ИмяТипПо умолчанию
argsReckfell.Collections.Array—
args

Общий Array параметров BiDi-парсера. Getter и setter разделяют контейнер; изменение alias не запускает shaping. Для обновления создайте копию до изменения и назначьте её через setter.

SetTextvoid
# SetText
C#
public void SetText(string text);

Исходное значение поля, пустое по умолчанию. Setter заменяет текст с учётом MaxLength, очищает выделение/прежнюю историю и сбрасывает курсор/прокрутку в начало. TextChanged не испускается; переполнение может испустить TextChangeRejected.

Параметры
ИмяТипПо умолчанию
textstring—
text

Исходное значение поля, пустое по умолчанию. Setter заменяет текст с учётом MaxLength, очищает выделение/прежнюю историю и сбрасывает курсор/прокрутку в начало. TextChanged не испускается; переполнение может испустить TextChangeRejected.

SetTextDirectionvoid
# SetTextDirection
C#
public void SetTextDirection(Control.TextDirection direction);

Направление формирования текста, Auto по умолчанию. Inherited берёт направление раскладки; Ltr/Rtl задают направление явно. Не переписывает строку в обратном порядке и не заменяет LayoutDirection.

Параметры
ИмяТипПо умолчанию
directionControl.TextDirection—
direction

Направление формирования текста, Auto по умолчанию. Inherited берёт направление раскладки; Ltr/Rtl задают направление явно. Не переписывает строку в обратном порядке и не заменяет LayoutDirection.

SetVirtualKeyboardEnabledvoid
# SetVirtualKeyboardEnabled
C#
public void SetVirtualKeyboardEnabled(bool enable);

Разрешает запросы виртуальной клавиатуры на поддерживаемой платформе, true по умолчанию. Не создаёт собственную клавиатуру и не запрещает аппаратный ввод при false.

Параметры
ИмяТипПо умолчанию
enablebool—
enable

Разрешает запросы виртуальной клавиатуры на поддерживаемой платформе, true по умолчанию. Не создаёт собственную клавиатуру и не запрещает аппаратный ввод при false.

SetVirtualKeyboardShowOnFocusvoid
# SetVirtualKeyboardShowOnFocus
C#
public void SetVirtualKeyboardShowOnFocus(bool showOnFocus);

Запрашивать виртуальную клавиатуру при получении фокуса, true по умолчанию. Нужны VirtualKeyboardEnabled и поддержка платформы. Явный Edit может запросить клавиатуру и при false.

Параметры
ИмяТипПо умолчанию
showOnFocusbool—
showOnFocus

Запрашивать виртуальную клавиатуру при получении фокуса, true по умолчанию. Нужны VirtualKeyboardEnabled и поддержка платформы. Явный Edit может запросить клавиатуру и при false.

SetVirtualKeyboardTypevoid
# SetVirtualKeyboardType
C#
public void SetVirtualKeyboardType(LineEdit.VirtualKeyboardTypeEnum type);

Подсказка платформе о типе клавиатуры, Default по умолчанию. Number/EmailAddress и другие варианты не фильтруют Text и не заменяют проверку введённых данных.

Параметры
ИмяТипПо умолчанию
typeLineEdit.VirtualKeyboardTypeEnum—
type

Подсказка платформе о типе клавиатуры, Default по умолчанию. Number/EmailAddress и другие варианты не фильтруют Text и не заменяют проверку введённых данных.

Uneditvoid
# Unedit
C#
public void Unedit();

Завершает активное редактирование, применяет текущую IME-композицию и при необходимости скрывает виртуальную клавиатуру. Фокус не снимает и сам EditingToggled не испускает. Снятие выделения зависит от DeselectOnFocusLossEnabled и перетаскивания.

Сигналы и события4

EditingToggledСобытие
# EditingToggled
C#
public event LineEdit.EditingToggledEventHandler EditingToggled;

Уведомление из путей фокуса, пользовательских действий и изменения Editable. Не является универсальным наблюдателем IsEditing: прямые Edit/Unedit при уже имеющемся фокусе могут не испускать его. В обработчике читайте IsEditing для текущего состояния.

Параметры обработчика
ИмяТипПо умолчанию
toggledOnbool—
toggledOn

Запрошенное состояние данного пути уведомления; фактическое читайте через IsEditing.

TextChangeRejectedСобытие
# TextChangeRejected
C#
public event LineEdit.TextChangeRejectedEventHandler TextChangeRejected;

Часть вставки не поместилась в MaxLength. Передаёт отброшенный хвост, а доступный префикс принимается. Возможен при SetText и изменении MaxLength, даже когда TextChanged не испускается.

Параметры обработчика
ИмяТипПо умолчанию
rejectedSubstringstring—
rejectedSubstring

Хвост вставки, не поместившийся в лимит кодовых точек.

TextChangedСобытие
# TextChanged
C#
public event LineEdit.TextChangedEventHandler TextChanged;

Уведомление об изменении текста при пользовательском редактировании и некоторых программных операциях. Text/SetText и InsertTextAtCaret сами его не испускают; Clear и DeleteCharAtCaret испускают сразу, DeleteText — отложенно в дереве. Не используйте как универсальное наблюдение всех записей Text.

Параметры обработчика
ИмяТипПо умолчанию
newTextstring—
newText

Исходный текст поля на момент уведомления, без маски и подсказки.

TextSubmittedСобытие
# TextSubmitted
C#
public event LineEdit.TextSubmittedEventHandler TextSubmitted;

Подтверждение строки действием ui_text_submit, обычно Enter. Передаёт текущий исходный текст; присваивание Text сигнал не вызывает. Проверяйте значение по правилам приложения перед сохранением.

Параметры обработчика
ИмяТипПо умолчанию
newTextstring—
newText

Исходный текст поля на момент уведомления, без маски и подсказки.

LineEdit.ExpandMode

ЗначениеОписание
FitToLineEdit = 2

Измените размер правой иконки, чтобы она соответствовала размеру окна LineEdit.

FitToText = 1

Измените размер правой иконки так, чтобы он соответствовал размеру текста.

OriginalSize = 0

Для правой иконки используйте исходный размер.

LineEdit.MenuItems

ЗначениеОписание
Clear = 3

Стирает весь текст LineEdit.

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

Представляет размер перечисления LineEdit.MenuItems.

  • КЕЙБОРД_ТИПЕ_ДЕФАУЛЬТ
Paste = 2

Вставить текст буфера обмена на выбранный текст (или в позиции eldet). Непечатанные символы эвакуации автоматически удаляются из OS буфер обмена через String.strip_escapes.

Redo = 6

Отменить последнее отмененное действие.

SelectAll = 4

Выделяет весь текст LineEdit.

SubmenuInsertUcc = 13

Идентификатор "Включить" Control Символ" субмену.

SubmenuTextDir = 7

Идентификатор подменю «Направление написания текста».

Undo = 5

Отменяет предыдущее действие.

LineEdit.VirtualKeyboardTypeEnum

ЗначениеОписание
Default = 0

Текстовая виртуальная клавиатура по умолчанию.

  • КЕЙБОРД_ТИПЕ_МНОГОЛИНА
EmailAddress = 5

Виртуальная клавиатура с дополнительными клавишами для облегчения ввода адресов электронной почты.

Multiline = 1

Многострочная виртуальная клавиатура.

Number = 2

Виртуальная цифровая клавиатура, полезная для ввода ПИН-кода.

NumberDecimal = 3

Виртуальная цифровая клавиатура, полезная для ввода дробных чисел.

Password = 6

Виртуальная клавиатура для ввода пароля. На большинстве платформ это должно отключить автозаполнение и автоматическую капитализацию. Примечание: Это не поддерживается в Web. Вместо этого это ведет себя идентично LineEdit.VirtualKeyboardTypeEnum.Default.

Phone = 4

Виртуальная клавиатура для набора номера телефона.

  • КЕЙБОРД_ТИПЕ_МАЙЛ
Url = 7

Виртуальная клавиатура с дополнительными клавишами для облегчения ввода URL-адресов.

Свойства темы

Это ключи ресурсов Theme, а не свойства C# класса. Используйте методы GetTheme…() и AddTheme…Override() у Control с соответствующим типом значения.

Ключ и типОписание
caret_color
Color

Color ЗАПЛАНИРОВАННЫЕ ЗАСЕДАНИЯ LineEdit's Избран (текстовый курсор). Это может быть полностью прозрачным цветом, чтобы полностью спрятать заботливость.

По умолчанию: Color(0.95, 0.95, 0.95, 1)
clear_button_color
Color

Color Используется как по умолчанию для прозрачной кнопки.

По умолчанию: Color(0.875, 0.875, 0.875, 1)
clear_button_color_pressed
Color

Color используется для прозрачной кнопки при нажатии.

По умолчанию: Color(1, 1, 1, 1)
font_color
Color

Цвет шрифта по умолч.

По умолчанию: Color(0.875, 0.875, 0.875, 1)
font_outline_color
Color

Оттенок контура текста LineEdit.

По умолчанию: Color(0, 0, 0, 1)
font_placeholder_color
Color

Font цвет для LineEdit.PlaceholderText.

По умолчанию: Color(0.875, 0.875, 0.875, 0.6)
font_selected_color
Color

Font Цвет выбранного текста (внутри прямоугольника).

По умолчанию: Color(1, 1, 1, 1)
font_uneditable_color
Color

Font цвет при отключении редактирования.

По умолчанию: Color(0.875, 0.875, 0.875, 0.5)
selection_color
Color

Color прямоугольника отбора.

По умолчанию: Color(0.5, 0.5, 0.5, 1)
caret_width
int

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

По умолчанию: 1
minimum_character_width
int

Минимальное горизонтальное пространство для текста (не считая четкой кнопки и поля содержания). Это значение измеряется по количеству символов "W" (т.е. это число символов "W" может быть показано без прокручивания).

По умолчанию: 4
outline_size
int

Размер контура текста. Примечание: При использовании шрифта с включенным FontFile.MultichannelSignedDistanceField его FontFile.MsdfPixelRange должен быть установлен как минимум в дважды значения LineEdit.outline_size, чтобы контур выглядел правильно. В противном случае контур может оказаться обрезанным раньше, чем предполагалось.

По умолчанию: 0
font
Font

Font используется для текста.

font_size
int

Font размер LineEditЭто смс.

clear
Texture2D

Texture для прозрачной кнопки. LineEdit.ClearButtonEnabled.

caret_move_rejected_sound
AudioStream

Играли, когда попробовали переместить лечебницу с помощью стрелок, [КБд] Дом[/kbd], [kbd]В конце[/kbd], [КБд.[/kbd], или [КБд вниз[/kBd], но ласка не двигается, так как она уже в начале/концах текста.

caret_moved_sound
AudioStream

Играл, когда хитрость перемещалась с помощью стрелочных клавиш, [КБд] Дом[/kbd], [kbd]В конце[/kbd], [КБд.[/kbd], [КБд вниз[/kbd], или мышиные щелчки.

Сосредоточься.

focus_sound
AudioStream

Играл, когда это LineEdit Мышь или мышечная фокусировка не играют в фокус-звук.

text_change_rejected_sound
AudioStream

Воспроизведено, когда изменение текста отклоняется (например, при нажатии заднего пространства в отсутствие текста или когда LineEdit.MaxLength превышены).

text_changed_sound
AudioStream

Воспроизводится при успешном изменении текста с помощью ввода клавиатуры (физического или виртуального).

text_submitted_sound
AudioStream

Воспроизводится при представлении текста с использованием ui_text_submit Мотор.

Сосредоточься

focus
StyleBox

Фон используется, когда LineEdit имеет фокус GUI. StyleBox отображается над базовым StyleBox, поэтому следует использовать частично прозрачный StyleBox, чтобы базовый StyleBox оставался видимым. StyleBox, представляющий контур или подчеркивание, хорошо подходит для этой цели. Чтобы отключить визуальный эффект фокуса, назначьте ресурс StyleBoxEmpty. Обратите внимание, что отключение визуального эффекта фокуса навредит удобству использования навигации с помощью клавиатуры/контроллера, поэтому это не рекомендуется по соображениям доступности.

normal
StyleBox

Фон по умолчанию для LineEdit.

read_only
StyleBox

Фон используется, когда LineEdit находится в режиме только для чтения (LineEdit.Editable имеет значение false).

Документация Reckfell EngineНаверх ↑
БЫСТРЫЙ ПЕРЕХОДНачало работыEntity и иерархияC# & .NET 10Сцены и префабы
Руководства и полный API Reckfell K
reckfellENGINE
RECKFELL ACCOUNT

Вход в аккаунт

Войдите в аккаунт Reckfell.

Один аккаунт для всей платформы Reckfell.