LinkButton
Текстовая кнопка-ссылка с необязательным системным открытием URI.
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Конструктор
public LinkButton();Создаёт текстовую ссылку: Uri пустой, Underline = Always, FocusMode = Accessibility, курсор PointingHand. Для обычного Tab задайте FocusMode = All.
Свойства9
EllipsisCharСвойство
public string EllipsisChar { get; set; }Символ сокращения, … по умолчанию. Используйте один Unicode-символ: более длинная строка предупреждает и сохраняет первый. Не меняет выбранный TextOverrunBehavior.
LanguageСвойство
public string Language { get; set; }Язык шейпинга; пустая строка использует локаль Control. Не переключает язык приложения и не заменяет исходный Text переводом.
StructuredTextBidiOverrideСвойство
public TextServer.StructuredTextParser StructuredTextBidiOverride { get; set; }Парсер структуры подписи для BiDi, Default по умолчанию. URI/Email/File и другие режимы обрабатывают смешанные направления текста, а не открывают адрес или переводят надпись.
StructuredTextBidiOverrideOptionsСвойство
public Reckfell.Collections.Array StructuredTextBidiOverrideOptions { get; set; }Общий Array параметров структурированного BiDi-парсера. Getter/setter разделяют массив; изменение alias не запускает повторный шейпинг. Измените независимую копию и назначьте обратно для обновления.
TextСвойство
public string Text { get; set; }Исходная подпись, пустая по умолчанию. Getter возвращает строку до перевода и сокращения. Не задаёт Uri автоматически.
TextDirectionСвойство
public Control.TextDirection TextDirection { get; set; }Направление текста, Auto по умолчанию. Inherited использует LayoutDirection Control. Не проверяет направление или корректность Uri.
TextOverrunBehaviorСвойство
public TextServer.OverrunBehavior TextOverrunBehavior { get; set; }Сокращение однострочной подписи при нехватке ширины, NoTrimming по умолчанию. Включение убирает естественную ширину текста из минимума; область ограничивает родитель. Text/Uri не меняются.
UnderlineСвойство
public LinkButton.UnderlineMode Underline { get; set; }Always, OnHover или Never, Always по умолчанию. OnHover также использует подчёркивание при нажатом состоянии. Управляет рисунком, не кликабельностью.
UriСвойство
public string Uri { get; set; }Цель системного открытия, пустая по умолчанию. Setter только сохраняет; активация с непустым Uri вызывает shell_open, включая Press. Для собственного действия оставьте пустым; Pressed не отменяет встроенное открытие.
Методы18
GetEllipsisCharstring
public string GetEllipsisChar();Символ сокращения, … по умолчанию. Используйте один Unicode-символ: более длинная строка предупреждает и сохраняет первый. Не меняет выбранный TextOverrunBehavior.
stringСохранённая строка символа сокращения.
GetLanguagestring
public string GetLanguage();Язык шейпинга; пустая строка использует локаль Control. Не переключает язык приложения и не заменяет исходный Text переводом.
stringСохранённый код языка либо пустая строка для локали Control.
GetStructuredTextBidiOverrideTextServer.StructuredTextParser
public TextServer.StructuredTextParser GetStructuredTextBidiOverride();Парсер структуры подписи для BiDi, Default по умолчанию. URI/Email/File и другие режимы обрабатывают смешанные направления текста, а не открывают адрес или переводят надпись.
TextServer.StructuredTextParserВыбранный TextServer.StructuredTextParser.
GetStructuredTextBidiOverrideOptionsReckfell.Collections.Array
public Reckfell.Collections.Array GetStructuredTextBidiOverrideOptions();Общий Array параметров структурированного BiDi-парсера. Getter/setter разделяют массив; изменение alias не запускает повторный шейпинг. Измените независимую копию и назначьте обратно для обновления.
Reckfell.Collections.ArrayОбщий Array параметров; редактирование меняет хранимый массив.
GetTextstring
public string GetText();Исходная подпись, пустая по умолчанию. Getter возвращает строку до перевода и сокращения. Не задаёт Uri автоматически.
stringИсходная подпись до перевода и сокращения.
GetTextDirectionControl.TextDirection
public Control.TextDirection GetTextDirection();Направление текста, Auto по умолчанию. Inherited использует LayoutDirection Control. Не проверяет направление или корректность Uri.
Control.TextDirectionСохранённый Control.TextDirection.
GetTextOverrunBehaviorTextServer.OverrunBehavior
public TextServer.OverrunBehavior GetTextOverrunBehavior();Сокращение однострочной подписи при нехватке ширины, NoTrimming по умолчанию. Включение убирает естественную ширину текста из минимума; область ограничивает родитель. Text/Uri не меняются.
TextServer.OverrunBehaviorВыбранный TextServer.OverrunBehavior.
GetUnderlineModeLinkButton.UnderlineMode
public LinkButton.UnderlineMode GetUnderlineMode();Always, OnHover или Never, Always по умолчанию. OnHover также использует подчёркивание при нажатом состоянии. Управляет рисунком, не кликабельностью.
LinkButton.UnderlineModeВыбранный LinkButton.UnderlineMode.
GetUristring
public string GetUri();Цель системного открытия, пустая по умолчанию. Setter только сохраняет; активация с непустым Uri вызывает shell_open, включая Press. Для собственного действия оставьте пустым; Pressed не отменяет встроенное открытие.
stringСохранённая цель открытия либо пустая строка.
SetEllipsisCharvoid
public void SetEllipsisChar(string @char);Символ сокращения, … по умолчанию. Используйте один Unicode-символ: более длинная строка предупреждает и сохраняет первый. Не меняет выбранный TextOverrunBehavior.
| Имя | Тип | По умолчанию |
|---|---|---|
char | string | — |
charСимвол сокращения, … по умолчанию. Используйте один Unicode-символ: более длинная строка предупреждает и сохраняет первый. Не меняет выбранный TextOverrunBehavior.
SetLanguagevoid
public void SetLanguage(string language);Язык шейпинга; пустая строка использует локаль Control. Не переключает язык приложения и не заменяет исходный Text переводом.
| Имя | Тип | По умолчанию |
|---|---|---|
language | string | — |
languageЯзык шейпинга; пустая строка использует локаль Control. Не переключает язык приложения и не заменяет исходный Text переводом.
SetStructuredTextBidiOverridevoid
public void SetStructuredTextBidiOverride(TextServer.StructuredTextParser parser);Парсер структуры подписи для BiDi, Default по умолчанию. URI/Email/File и другие режимы обрабатывают смешанные направления текста, а не открывают адрес или переводят надпись.
| Имя | Тип | По умолчанию |
|---|---|---|
parser | TextServer.StructuredTextParser | — |
parserПарсер структуры подписи для BiDi, Default по умолчанию. URI/Email/File и другие режимы обрабатывают смешанные направления текста, а не открывают адрес или переводят надпись.
SetStructuredTextBidiOverrideOptionsvoid
public void SetStructuredTextBidiOverrideOptions(Reckfell.Collections.Array args);Общий Array параметров структурированного BiDi-парсера. Getter/setter разделяют массив; изменение alias не запускает повторный шейпинг. Измените независимую копию и назначьте обратно для обновления.
| Имя | Тип | По умолчанию |
|---|---|---|
args | Reckfell.Collections.Array | — |
argsОбщий Array параметров структурированного BiDi-парсера. Getter/setter разделяют массив; изменение alias не запускает повторный шейпинг. Измените независимую копию и назначьте обратно для обновления.
SetTextvoid
public void SetText(string text);Исходная подпись, пустая по умолчанию. Getter возвращает строку до перевода и сокращения. Не задаёт Uri автоматически.
| Имя | Тип | По умолчанию |
|---|---|---|
text | string | — |
textИсходная подпись, пустая по умолчанию. Getter возвращает строку до перевода и сокращения. Не задаёт Uri автоматически.
SetTextDirectionvoid
public void SetTextDirection(Control.TextDirection direction);Направление текста, Auto по умолчанию. Inherited использует LayoutDirection Control. Не проверяет направление или корректность Uri.
| Имя | Тип | По умолчанию |
|---|---|---|
direction | Control.TextDirection | — |
directionНаправление текста, Auto по умолчанию. Inherited использует LayoutDirection Control. Не проверяет направление или корректность Uri.
SetTextOverrunBehaviorvoid
public void SetTextOverrunBehavior(TextServer.OverrunBehavior overrunBehavior);Сокращение однострочной подписи при нехватке ширины, NoTrimming по умолчанию. Включение убирает естественную ширину текста из минимума; область ограничивает родитель. Text/Uri не меняются.
| Имя | Тип | По умолчанию |
|---|---|---|
overrunBehavior | TextServer.OverrunBehavior | — |
overrunBehaviorСокращение однострочной подписи при нехватке ширины, NoTrimming по умолчанию. Включение убирает естественную ширину текста из минимума; область ограничивает родитель. Text/Uri не меняются.
SetUnderlineModevoid
public void SetUnderlineMode(LinkButton.UnderlineMode underlineMode);Always, OnHover или Never, Always по умолчанию. OnHover также использует подчёркивание при нажатом состоянии. Управляет рисунком, не кликабельностью.
| Имя | Тип | По умолчанию |
|---|---|---|
underlineMode | LinkButton.UnderlineMode | — |
underlineModeAlways, OnHover или Never, Always по умолчанию. OnHover также использует подчёркивание при нажатом состоянии. Управляет рисунком, не кликабельностью.
SetUrivoid
public void SetUri(string uri);Цель системного открытия, пустая по умолчанию. Setter только сохраняет; активация с непустым Uri вызывает shell_open, включая Press. Для собственного действия оставьте пустым; Pressed не отменяет встроенное открытие.
| Имя | Тип | По умолчанию |
|---|---|---|
uri | string | — |
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_colorColor |
Color(0.875, 0.875, 0.875, 1) |
font_disabled_colorColor |
Color(0, 0, 0, 1) |
font_focus_colorColor |
Color(0.95, 0.95, 0.95, 1) |
font_hover_colorColor |
Color(0.95, 0.95, 0.95, 1) |
font_hover_pressed_colorColor |
Color(0, 0, 0, 1) |
font_outline_colorColor | Оттенок контура текста Color(0, 0, 0, 1) |
font_pressed_colorColor |
Color(1, 1, 1, 1) |
outline_sizeint | Размер контура текста.
Примечание: При использовании шрифта с включенным 0 |
underline_spacingint | Вертикальное пространство между базовой линией текста и подчеркиванием. По умолчанию:2 |
fontFont |
|
font_sizeint | Font размер Сосредоточься |
focusStyleBox |
|