Label

public Label();

Создаёт обычную надпись: Text пустой, Left/Top, AutowrapMode = Off, VisibleCharacters = -1, MouseFilter = Ignore, вертикальный SizeFlags ShrinkCenter.

public TextServer.AutowrapMode AutowrapMode { get; set; }

Перенос, Off по умолчанию. WordSmart переносит слова и разбивает длинные фрагменты, Arbitrary использует границы графем. Нужна ограниченная ширина; добавьте положительный минимум или максимум ширины для устойчивой раскладки.

public TextServer.LineBreakFlag AutowrapTrimFlags { get; set; }

Удаление краевых пробелов строк, по умолчанию TrimStartEdgeSpaces | TrimEndEdgeSpaces. Остальные биты LineBreakFlag отбрасываются; они не задают режим переноса.

public bool ClipText { get; set; }

Обрезание по области, false по умолчанию. Снимает естественную ширину текста из минимума; не включает многоточие автоматически и не отменяет CustomMinimumSize/поля стиля.

public string EllipsisChar { get; set; }

Символ сокращения, … по умолчанию. Используйте один Unicode-символ; более длинная строка предупреждает и сокращается до первого. Не включает TextOverrunBehavior автоматически.

public HorizontalAlignment HorizontalAlignment { get; set; }

Left/Center/Right/Fill для текста внутри области, Left по умолчанию. Left/Right учитывают RTL LayoutDirection; Fill использует JustificationFlags. Не перемещает сам Control.

public TextServer.JustificationFlag JustificationFlags { get; set; }

Флаги растяжения текста для HorizontalAlignment = Fill, включая границы слов, кашиду и правила последней строки. Не включают Fill сами по себе.

public LabelSettings LabelSettings { get; set; }

Общий ресурс оформления с приоритетом над соответствующими theme-значениями; null возвращает оформление к теме. Изменения ресурса инвалидируют шейпинг всех использующих его Label. Если Font ресурса отсутствует, возможен шрифт темы.

public string Language { get; set; }

Язык обработки текста этого Label. Не меняет глобальную локаль TranslationServer и не выбирает другой каталог перевода. Выбор перевода и обработку символов проверяйте отдельно.

public int LinesSkipped { get; set; }

Неотрицательное число пропускаемых строк, 0 по умолчанию. Не удаляет символы из Text; влияет на окно рисования и CharacterBounds.

public int MaxLinesVisible { get; set; }

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

public int MaximumFontSize { get; set; }

Верхняя граница подбора, 60 по умолчанию. Не ограничивает обычный theme/LabelSettings размер при выключенном ResizeFontToFit. Обеспечьте положительное maximum ≥ minimum.

public int MinimumFontSize { get; set; }

Нижняя граница подбора и его минимального вертикального размера, 10 по умолчанию. Проверяйте 1 ≤ minimum ≤ maximum сами: setter не ограничивает число.

public string ParagraphSeparator { get; set; }

Разделитель абзацев с c_unescape; строка \n по умолчанию означает перевод строки. Не является регулярным выражением и не задаёт расстояние между абзацами.

public bool ResizeFontToFit { get; set; }

Подбирать размер между MinimumFontSize/MaximumFontSize по ширине и высоте области, false по умолчанию. Подбор может увеличить и уменьшить размер. Если даже minimum не помещается, обрезание всё ещё возможно.

public TextServer.StructuredTextParser StructuredTextBidiOverride { get; set; }

Структурированный BiDi-парсер для URI, файловых путей и других смешанных направлений. Обрабатывает текст, не открывает адрес и не выполняет перевод.

public Reckfell.Collections.Array StructuredTextBidiOverrideOptions { get; set; }

Общий Array параметров BiDi-парсера. Alias-изменения не инвалидируют шейпинг; повторная запись того же массива также может ничего не обновить. Скопируйте массив до изменения и назначьте новую версию.

public float[] TabStops { get; set; }

Массив позиций табуляции в пикселях. C# float[] копируется при чтении и передаче; измените копию и присвойте обратно. Это не число пробелов и не размеры колонок контейнера.

public string Text { get; set; }

Исходный текст или ключ автоматического перевода. При переводе Label хранит здесь исходное значение, а внутренний текст отображения меняется по локали и контексту. Для пользовательского текста отключите автоматический перевод. Присваивание того же значения не принуждает повторный поиск перевода.

public Control.TextDirection TextDirection { get; set; }

Направление обработки текста, Auto по умолчанию. Inherited берёт направление раскладки Control. Не заменяет LayoutDirection для положения строк и GlyphsAuto.

public TextServer.OverrunBehavior TextOverrunBehavior { get; set; }

Сокращение при нехватке места, NoTrimming по умолчанию. Выберите TrimChar/TrimWord или подходящий Ellipsis-вариант. Не меняет исходный Text; результат зависит от переноса, области и числа видимых строк.

public bool Uppercase { get; set; }

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

public VerticalAlignment VerticalAlignment { get; set; }

Top/Center/Bottom/Fill внутри области, Top по умолчанию. Не заменяет LinesSkipped и не меняет родительскую раскладку Control.

public int VisibleCharacters { get; set; }

Число позиций для появления: -1 — все, иначе используйте 0…GetTotalCharacterCount. Не является числом C# char или графем; смысл зависит от VisibleCharactersBehavior. Избыточное число не ограничивается и может вывести VisibleRatio за 1.

public TextServer.VisibleCharactersBehavior VisibleCharactersBehavior { get; set; }

CharsBeforeShaping по умолчанию обрезает вход до подготовки; CharsAfterShaping сохраняет полную раскладку. GlyphsAuto/Ltr/Rtl раскрывают глифы по направлению, не целые пользовательские текстовые элементы.

public float VisibleRatio { get; set; }

Доля появления, 1 по умолчанию. Изменённая доля ≥1 показывает всё, отрицательная даёт 0, промежуточная округляет число позиций вниз. Если через VisibleCharacters уже сохранено то же значение за пределами диапазона, повторная запись не нормализует его. Передавайте конечные 0…1.

public TextServer.AutowrapMode GetAutowrapMode();

Перенос, Off по умолчанию. WordSmart переносит слова и разбивает длинные фрагменты, Arbitrary использует границы графем. Нужна ограниченная ширина; добавьте положительный минимум или максимум ширины для устойчивой раскладки.

public TextServer.LineBreakFlag GetAutowrapTrimFlags();

Удаление краевых пробелов строк, по умолчанию TrimStartEdgeSpaces | TrimEndEdgeSpaces. Остальные биты LineBreakFlag отбрасываются; они не задают режим переноса.

public Rect2 GetCharacterBounds(int pos);

Локальная рамка продвижения кластера для позиции кодовой точки. Учитывает раскладку и пропуск строк; несколько позиций могут иметь общую рамку. Пустой Rect2 означает отсутствие соответствующей рамки, не обязательно ошибку. Это не tight bounds пикселей.

public string GetEllipsisChar();

Символ сокращения, … по умолчанию. Используйте один Unicode-символ; более длинная строка предупреждает и сокращается до первого. Не включает TextOverrunBehavior автоматически.

public HorizontalAlignment GetHorizontalAlignment();

Left/Center/Right/Fill для текста внутри области, Left по умолчанию. Left/Right учитывают RTL LayoutDirection; Fill использует JustificationFlags. Не перемещает сам Control.

public TextServer.JustificationFlag GetJustificationFlags();

Флаги растяжения текста для HorizontalAlignment = Fill, включая границы слов, кашиду и правила последней строки. Не включают Fill сами по себе.

public LabelSettings GetLabelSettings();

Общий ресурс оформления с приоритетом над соответствующими theme-значениями; null возвращает оформление к теме. Изменения ресурса инвалидируют шейпинг всех использующих его Label. Если Font ресурса отсутствует, возможен шрифт темы.

public string GetLanguage();

Язык шейпинга и преобразования регистра; пустая строка использует локаль Control. Не переключает язык приложения и не возвращает перевод из GetText.

public int GetLineCount();

Подготавливает текст при необходимости и возвращает общее число строк после переноса. Вне дерева возвращает 1. Результат зависит от режима появления до шейпинга, но не равен числу видимых на экране строк.

public int GetLineHeight(int line = -1);

Высота подготовленной строки в пикселях. Для -1 или индекса вне диапазона возвращает максимальную высоту строк/шрифта, а не ошибку. Перед измерением подготовьте раскладку через GetLineCount.

public int GetLinesSkipped();

Неотрицательное число пропускаемых строк, 0 по умолчанию. Не удаляет символы из Text; влияет на окно рисования и CharacterBounds.

public int GetMaxLinesVisible();

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

public int GetMaximumFontSize();

Верхняя граница подбора, 60 по умолчанию. Не ограничивает обычный theme/LabelSettings размер при выключенном ResizeFontToFit. Обеспечьте положительное maximum ≥ minimum.

public int GetMinimumFontSize();

Нижняя граница подбора и его минимального вертикального размера, 10 по умолчанию. Проверяйте 1 ≤ minimum ≤ maximum сами: setter не ограничивает число.

public string GetParagraphSeparator();

Разделитель абзацев с c_unescape; строка \n по умолчанию означает перевод строки. Не является регулярным выражением и не задаёт расстояние между абзацами.

public int GetRenderedFontSize();

Последний рассчитанный размер шрифта или базовый размер. Getter сам не запускает новый подбор: после изменения области/настроек сначала вызовите GetLineCount/GetMinimumSize.

public TextServer.StructuredTextParser GetStructuredTextBidiOverride();

Структурированный BiDi-парсер для URI, файловых путей и других смешанных направлений. Обрабатывает текст, не открывает адрес и не выполняет перевод.

public Reckfell.Collections.Array GetStructuredTextBidiOverrideOptions();

Общий Array параметров BiDi-парсера. Alias-изменения не инвалидируют шейпинг; повторная запись того же массива также может ничего не обновить. Скопируйте массив до изменения и назначьте новую версию.

public float[] GetTabStops();

Массив позиций табуляции в пикселях. C# float[] копируется при чтении и передаче; измените копию и присвойте обратно. Это не число пробелов и не размеры колонок контейнера.

public string GetText();

Исходный обычный текст, не BBCode. Getter возвращает исходник, тогда как подсчёт символов использует переведённую строку. При частичном VisibleRatio замена текста пересчитывает VisibleCharacters по сохранённой доле.

public Control.TextDirection GetTextDirection();

Направление обработки текста, Auto по умолчанию. Inherited берёт направление раскладки Control. Не заменяет LayoutDirection для положения строк и GlyphsAuto.

public TextServer.OverrunBehavior GetTextOverrunBehavior();

Сокращение при нехватке места, NoTrimming по умолчанию. Выберите TrimChar/TrimWord или подходящий Ellipsis-вариант. Не меняет исходный Text; результат зависит от переноса, области и числа видимых строк.

public int GetTotalCharacterCount();

Возвращает длину внутреннего переведённого текста Label. Может отличаться от длины Text, который сохраняет исходный ключ. Это не число отрисованных глифов и не проверка отсутствия обрезки.

public VerticalAlignment GetVerticalAlignment();

Top/Center/Bottom/Fill внутри области, Top по умолчанию. Не заменяет LinesSkipped и не меняет родительскую раскладку Control.

public int GetVisibleCharacters();

Число позиций для появления: -1 — все, иначе используйте 0…GetTotalCharacterCount. Не является числом C# char или графем; смысл зависит от VisibleCharactersBehavior. Избыточное число не ограничивается и может вывести VisibleRatio за 1.

public TextServer.VisibleCharactersBehavior GetVisibleCharactersBehavior();

CharsBeforeShaping по умолчанию обрезает вход до подготовки; CharsAfterShaping сохраняет полную раскладку. GlyphsAuto/Ltr/Rtl раскрывают глифы по направлению, не целые пользовательские текстовые элементы.

public int GetVisibleLineCount();

Считает помещающиеся строки подготовленной раскладки с LinesSkipped/MaxLinesVisible и высотой. Сам не запускает шейпинг: после изменения сначала вызовите GetLineCount/GetMinimumSize. Не считает реально раскрытые глифы.

public float GetVisibleRatio();

Доля появления, 1 по умолчанию. Изменённая доля ≥1 показывает всё, отрицательная даёт 0, промежуточная округляет число позиций вниз. Если через VisibleCharacters уже сохранено то же значение за пределами диапазона, повторная запись не нормализует его. Передавайте конечные 0…1.

public bool IsClippingText();

Обрезание по области, false по умолчанию. Снимает естественную ширину текста из минимума; не включает многоточие автоматически и не отменяет CustomMinimumSize/поля стиля.

public bool IsResizeFontToFitEnabled();

Подбирать размер между MinimumFontSize/MaximumFontSize по ширине и высоте области, false по умолчанию. Подбор может увеличить и уменьшить размер. Если даже minimum не помещается, обрезание всё ещё возможно.

public bool IsUppercase();

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

public void SetAutowrapMode(TextServer.AutowrapMode autowrapMode);

Перенос, Off по умолчанию. WordSmart переносит слова и разбивает длинные фрагменты, Arbitrary использует границы графем. Нужна ограниченная ширина; добавьте положительный минимум или максимум ширины для устойчивой раскладки.

public void SetAutowrapTrimFlags(TextServer.LineBreakFlag autowrapTrimFlags);

Удаление краевых пробелов строк, по умолчанию TrimStartEdgeSpaces | TrimEndEdgeSpaces. Остальные биты LineBreakFlag отбрасываются; они не задают режим переноса.

public void SetClipText(bool enable);

Обрезание по области, false по умолчанию. Снимает естественную ширину текста из минимума; не включает многоточие автоматически и не отменяет CustomMinimumSize/поля стиля.

public void SetEllipsisChar(string @char);

Символ сокращения, … по умолчанию. Используйте один Unicode-символ; более длинная строка предупреждает и сокращается до первого. Не включает TextOverrunBehavior автоматически.

public void SetHorizontalAlignment(HorizontalAlignment alignment);

Left/Center/Right/Fill для текста внутри области, Left по умолчанию. Left/Right учитывают RTL LayoutDirection; Fill использует JustificationFlags. Не перемещает сам Control.

public void SetJustificationFlags(TextServer.JustificationFlag justificationFlags);

Флаги растяжения текста для HorizontalAlignment = Fill, включая границы слов, кашиду и правила последней строки. Не включают Fill сами по себе.

public void SetLabelSettings(LabelSettings settings);

Общий ресурс оформления с приоритетом над соответствующими theme-значениями; null возвращает оформление к теме. Изменения ресурса инвалидируют шейпинг всех использующих его Label. Если Font ресурса отсутствует, возможен шрифт темы.

public void SetLanguage(string language);

Язык шейпинга и преобразования регистра; пустая строка использует локаль Control. Не переключает язык приложения и не возвращает перевод из GetText.

public void SetLinesSkipped(int linesSkipped);

Неотрицательное число пропускаемых строк, 0 по умолчанию. Не удаляет символы из Text; влияет на окно рисования и CharacterBounds.

public void SetMaxLinesVisible(int linesVisible);

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

public void SetMaximumFontSize(int size);

Верхняя граница подбора, 60 по умолчанию. Не ограничивает обычный theme/LabelSettings размер при выключенном ResizeFontToFit. Обеспечьте положительное maximum ≥ minimum.

public void SetMinimumFontSize(int size);

Нижняя граница подбора и его минимального вертикального размера, 10 по умолчанию. Проверяйте 1 ≤ minimum ≤ maximum сами: setter не ограничивает число.

public void SetParagraphSeparator(string paragraphSeparator);

Разделитель абзацев с c_unescape; строка \n по умолчанию означает перевод строки. Не является регулярным выражением и не задаёт расстояние между абзацами.

public void SetResizeFontToFit(bool enabled);

Подбирать размер между MinimumFontSize/MaximumFontSize по ширине и высоте области, false по умолчанию. Подбор может увеличить и уменьшить размер. Если даже minimum не помещается, обрезание всё ещё возможно.

public void SetStructuredTextBidiOverride(TextServer.StructuredTextParser parser);

Структурированный BiDi-парсер для URI, файловых путей и других смешанных направлений. Обрабатывает текст, не открывает адрес и не выполняет перевод.

public void SetStructuredTextBidiOverrideOptions(Reckfell.Collections.Array args);

Общий Array параметров BiDi-парсера. Alias-изменения не инвалидируют шейпинг; повторная запись того же массива также может ничего не обновить. Скопируйте массив до изменения и назначьте новую версию.

public void SetTabStops(ReadOnlySpan<float> tabStops);

Массив позиций табуляции в пикселях. C# float[] копируется при чтении и передаче; измените копию и присвойте обратно. Это не число пробелов и не размеры колонок контейнера.

public void SetTabStops(float[] tabStops);

Массив позиций табуляции в пикселях. C# float[] копируется при чтении и передаче; измените копию и присвойте обратно. Это не число пробелов и не размеры колонок контейнера.

public void SetText(string text);

Исходный обычный текст, не BBCode. Getter возвращает исходник, тогда как подсчёт символов использует переведённую строку. При частичном VisibleRatio замена текста пересчитывает VisibleCharacters по сохранённой доле.

public void SetTextDirection(Control.TextDirection direction);

Направление обработки текста, Auto по умолчанию. Inherited берёт направление раскладки Control. Не заменяет LayoutDirection для положения строк и GlyphsAuto.

public void SetTextOverrunBehavior(TextServer.OverrunBehavior overrunBehavior);

Сокращение при нехватке места, NoTrimming по умолчанию. Выберите TrimChar/TrimWord или подходящий Ellipsis-вариант. Не меняет исходный Text; результат зависит от переноса, области и числа видимых строк.

public void SetUppercase(bool enable);

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

public void SetVerticalAlignment(VerticalAlignment alignment);

Top/Center/Bottom/Fill внутри области, Top по умолчанию. Не заменяет LinesSkipped и не меняет родительскую раскладку Control.

public void SetVisibleCharacters(int amount);

Число позиций для появления: -1 — все, иначе используйте 0…GetTotalCharacterCount. Не является числом C# char или графем; смысл зависит от VisibleCharactersBehavior. Избыточное число не ограничивается и может вывести VisibleRatio за 1.

public void SetVisibleCharactersBehavior(TextServer.VisibleCharactersBehavior behavior);

CharsBeforeShaping по умолчанию обрезает вход до подготовки; CharsAfterShaping сохраняет полную раскладку. GlyphsAuto/Ltr/Rtl раскрывают глифы по направлению, не целые пользовательские текстовые элементы.

public void SetVisibleRatio(float ratio);

Доля появления, 1 по умолчанию. Изменённая доля ≥1 показывает всё, отрицательная даёт 0, промежуточная округляет число позиций вниз. Если через VisibleCharacters уже сохранено то же значение за пределами диапазона, повторная запись не нормализует его. Передавайте конечные 0…1.