reckfellENGINE

LinkButton

Текстовая кнопка-ссылка с необязательным системным открытием URI.

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

LinkButton использует поведение BaseButton и рисует текст с подчёркиванием. По умолчанию Underline = Always, TextOverrunBehavior = NoTrimming, Uri пустой. Для обычной навигации Tab явно задайте FocusMode = All: конструктор использует Accessibility.

Text — видимая подпись, Uri — отдельная цель. Назначение Uri не открывает её и не меняет Text. При активации непустой Uri передаётся системе через shell_open, в том числе при программном Press. Это не встроенный браузер и не маршрутизатор сайта. Обработчик Pressed вызывается после встроенного действия и не отменяет его. Если нужна собственная навигация или диалог, оставьте Uri пустым и обработайте Pressed самостоятельно.

Длинная строка по умолчанию входит в минимум ширины. Для сокращения задайте TextOverrunBehavior и ограничьте ширину родительской раскладкой. EllipsisChar задаёт один Unicode-символ вместо стандартного многоточия; строка длиннее одного символа вызывает предупреждение и сокращается до первого. Сокращение не изменяет Text или Uri. LinkButton использует однострочное отображение, не перенос Button.

Language задаёт язык обработки текста, TextDirection — направление; они не переводят исходную строку сами по себе. StructuredTextBidiOverride выбирает обработку структурированного текста, например URI или адреса почты, чтобы смешанные LTR/RTL-фрагменты отображались согласно структуре. Это обработка подписи, не проверка и не открытие Uri.

StructuredTextBidiOverrideOptions разделяет Array при чтении и записи. Изменение полученного массива меняет хранимые параметры, но не запускает повторный шейпинг. Для предсказуемого обновления сначала создайте независимый Array, измените его и назначьте обратно. Вложенные изменяемые значения также могут оставаться общими при неглубокой копии.

Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.

Конструкторы1

LinkButtonКонструктор
# LinkButton
C#
public LinkButton();

Создаёт текстовую ссылку: Uri пустой, Underline = Always, FocusMode = Accessibility, курсор PointingHand. Для обычного Tab задайте FocusMode = All.

Свойства9

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

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

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

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

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

Парсер структуры подписи для BiDi, Default по умолчанию. URI/Email/File и другие режимы обрабатывают смешанные направления текста, а не открывают адрес или переводят надпись.

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

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

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

Исходная подпись, пустая по умолчанию. Getter возвращает строку до перевода и сокращения. Не задаёт Uri автоматически.

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

Направление текста, Auto по умолчанию. Inherited использует LayoutDirection Control. Не проверяет направление или корректность Uri.

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

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

UnderlineСвойство
# Underline
C#
public LinkButton.UnderlineMode Underline { get; set; }

Always, OnHover или Never, Always по умолчанию. OnHover также использует подчёркивание при нажатом состоянии. Управляет рисунком, не кликабельностью.

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

Цель системного открытия, пустая по умолчанию. Setter только сохраняет; активация с непустым Uri вызывает shell_open, включая Press. Для собственного действия оставьте пустым; Pressed не отменяет встроенное открытие.

Методы18

GetEllipsisCharstring
# GetEllipsisChar
C#
public string GetEllipsisChar();

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

Возвращает string

Сохранённая строка символа сокращения.

GetLanguagestring
# GetLanguage
C#
public string GetLanguage();

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

Возвращает string

Сохранённый код языка либо пустая строка для локали Control.

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

Парсер структуры подписи для BiDi, Default по умолчанию. URI/Email/File и другие режимы обрабатывают смешанные направления текста, а не открывают адрес или переводят надпись.

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

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

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

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

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

Общий Array параметров; редактирование меняет хранимый массив.

GetTextstring
# GetText
C#
public string GetText();

Исходная подпись, пустая по умолчанию. Getter возвращает строку до перевода и сокращения. Не задаёт Uri автоматически.

Возвращает string

Исходная подпись до перевода и сокращения.

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

Направление текста, Auto по умолчанию. Inherited использует LayoutDirection Control. Не проверяет направление или корректность Uri.

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

Сохранённый Control.TextDirection.

GetTextOverrunBehaviorTextServer.OverrunBehavior
# GetTextOverrunBehavior
C#
public TextServer.OverrunBehavior GetTextOverrunBehavior();

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

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

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

GetUnderlineModeLinkButton.UnderlineMode
# GetUnderlineMode
C#
public LinkButton.UnderlineMode GetUnderlineMode();

Always, OnHover или Never, Always по умолчанию. OnHover также использует подчёркивание при нажатом состоянии. Управляет рисунком, не кликабельностью.

Возвращает LinkButton.UnderlineMode

Выбранный LinkButton.UnderlineMode.

GetUristring
# GetUri
C#
public string GetUri();

Цель системного открытия, пустая по умолчанию. Setter только сохраняет; активация с непустым Uri вызывает shell_open, включая Press. Для собственного действия оставьте пустым; Pressed не отменяет встроенное открытие.

Возвращает string

Сохранённая цель открытия либо пустая строка.

SetEllipsisCharvoid
# SetEllipsisChar
C#
public void SetEllipsisChar(string @char);

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

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

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

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

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

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

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

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

Парсер структуры подписи для BiDi, Default по умолчанию. URI/Email/File и другие режимы обрабатывают смешанные направления текста, а не открывают адрес или переводят надпись.

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

Парсер структуры подписи для BiDi, Default по умолчанию. URI/Email/File и другие режимы обрабатывают смешанные направления текста, а не открывают адрес или переводят надпись.

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

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

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

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

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

Исходная подпись, пустая по умолчанию. Getter возвращает строку до перевода и сокращения. Не задаёт Uri автоматически.

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

Исходная подпись, пустая по умолчанию. Getter возвращает строку до перевода и сокращения. Не задаёт Uri автоматически.

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

Направление текста, Auto по умолчанию. Inherited использует LayoutDirection Control. Не проверяет направление или корректность Uri.

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

Направление текста, Auto по умолчанию. Inherited использует LayoutDirection Control. Не проверяет направление или корректность Uri.

SetTextOverrunBehaviorvoid
# SetTextOverrunBehavior
C#
public void SetTextOverrunBehavior(TextServer.OverrunBehavior overrunBehavior);

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

Параметры
ИмяТипПо умолчанию
overrunBehaviorTextServer.OverrunBehavior—
overrunBehavior

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

SetUnderlineModevoid
# SetUnderlineMode
C#
public void SetUnderlineMode(LinkButton.UnderlineMode underlineMode);

Always, OnHover или Never, Always по умолчанию. OnHover также использует подчёркивание при нажатом состоянии. Управляет рисунком, не кликабельностью.

Параметры
ИмяТипПо умолчанию
underlineModeLinkButton.UnderlineMode—
underlineMode

Always, OnHover или Never, Always по умолчанию. OnHover также использует подчёркивание при нажатом состоянии. Управляет рисунком, не кликабельностью.

SetUrivoid
# SetUri
C#
public void SetUri(string uri);

Цель системного открытия, пустая по умолчанию. Setter только сохраняет; активация с непустым Uri вызывает shell_open, включая Press. Для собственного действия оставьте пустым; Pressed не отменяет встроенное открытие.

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

Цель системного открытия, пустая по умолчанию. Setter только сохраняет; активация с непустым Uri вызывает shell_open, включая Press. Для собственного действия оставьте пустым; Pressed не отменяет встроенное открытие.

LinkButton.UnderlineMode

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

В нижней части текста LinkButton всегда будет отображаться подчеркивание.

Never = 2

LinkButton никогда не будет отображать подчеркивание в нижней части текста.

OnHover = 1

При наведении курсора мыши на кнопку LinkButton в нижней части текста отображается подчеркивание.

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

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

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

Color Текст по умолчанию для LinkButton.

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

LinkButton отключен.

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

Color текста , используемый, когда LinkButton находится в фокусе. Заменяет только обычный цвет текста кнопки. Отключенные, наведенные и нажатые состояния имеют приоритет над этим цветом.

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

Color текста , используемый при наведении курсора на LinkButton.

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

Color текста, используемый при наведении и нажатии на LinkButton.

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

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

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

Color текста, используемый при нажатии LinkButton.

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

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

По умолчанию: 0
underline_spacing
int

Вертикальное пространство между базовой линией текста и подчеркиванием.

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

Font текста LinkButton.

font_size
int

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

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

focus
StyleBox

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

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

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

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

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