SpinBox
Числовое поле с выражениями и кнопками изменения.
SpinBox объединяет Range, внутренний LineEdit и кнопки изменения. По умолчанию Step = 1, Editable = true, UpdateOnTextChanged = false; дополнительные настройки формата и шага стрелок выключены. Для дробных значений задайте подходящий Step.
GetLineEdit возвращает принадлежащий SpinBox внутренний Control: настраивайте его, но не освобождайте и не переносите. Изменение LineEdit.Text из кода не равно записи Value и не испускает TextChanged. Чтобы применить такой текст, вызовите Apply. Например, текст 2 + 3 * 4 даёт Value = 14; результат затем округляется и ограничивается по правилам Range. Пустой или синтаксически неверный текст не заменяет прежнее число.
UpdateOnTextChanged подключает отложенную обработку сигнала внутреннего поля. Это не делает setter Text автоматическим числовым вводом. При включённом режиме промежуточные выражения могут пересчитывать Value до завершения редактирования; не связывайте дорогое действие с каждой введённой цифрой без необходимости.
Format управляет отображением вне активного редактирования. Используйте шаблон с одним значением: %s kg берёт стандартное представление с учётом Step; %.2f kg задаёт две цифры после точки в отображении, не меняя точность Value. Это формат sprintf движка, не шаблон C# string.Format. Неверный шаблон может показать <Invalid>. Prefix/Suffix устарели и действуют только при пустом Format.
FormatAutoTranslateMode по умолчанию Disabled. Для переводимых единиц задайте Format, при необходимости PluralFormat и включите подходящий режим перевода; одна строка PluralFormat без этого не создаёт локализацию.
CustomArrowStep = 0 использует Step; ненулевое значение меняет приращение кнопок, не сетку Range. CustomArrowRound привязывает переход к сетке шага стрелок; выбирайте его кратным Step, иначе переход может не менять число. Editable = false блокирует пользовательское редактирование, но не программные Value и Apply.
Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.
Конструкторы1
SpinBoxКонструктор
public SpinBox();Создаёт числовое поле с внутренним LineEdit и таймером кнопок. Step = 1, Editable = true, UpdateOnTextChanged = false; Format пустой.
Свойства11
AlignmentСвойство
public HorizontalAlignment Alignment { get; set; }Горизонтальное выравнивание текста внутреннего LineEdit, Left по умолчанию. Не меняет положение SpinBox в родительской раскладке.
CustomArrowRoundСвойство
public bool CustomArrowRound { get; set; }Привязывает переход кнопками к сетке CustomArrowStep вместо простого прибавления/вычитания, false по умолчанию. Шаг стрелок должен быть совместим с Step, иначе переход может не изменить Value.
CustomArrowStepСвойство
public double CustomArrowStep { get; set; }Приращение кнопок: 0 использует Step, ненулевое значение — собственный шаг. Не заменяет сетку Range, поэтому выбирайте совместимый шаг. Не пересчитывает текущее Value.
EditableСвойство
public bool Editable { get; set; }Разрешает пользовательское редактирование внутреннего LineEdit и кнопками, true по умолчанию. Не блокирует программное Value или Apply.
FormatСвойство
public string Format { get; set; }Шаблон sprintf с одним значением для отображения вне редактирования. %s использует стандартное представление по Step, %.2f задаёт две дробные цифры в надписи. Не меняет Value; имеет приоритет над Prefix/Suffix. Неверный шаблон может показать <Invalid>.
FormatAutoTranslateModeСвойство
public Entity.AutoTranslateModeEnum FormatAutoTranslateMode { get; set; }Режим автоматического перевода Format/PluralFormat: Disabled по умолчанию, Always принудительно включает, Inherit учитывает перевод сущности. Сам по себе не добавляет переводов в каталог.
PluralFormatСвойство
public string PluralFormat { get; set; }Шаблон множественной формы для перевода Format. Работает при непустом Format и включённом переводе через FormatAutoTranslateMode; выбор формы использует Value и каталог переводов.
PrefixСвойство · Устарело
public string Prefix { get; set; }Устаревший префикс отображения с пробелом перед числом. Действует только при пустом Format и вне редактирования. Для нового кода используйте Format.
SelectAllOnFocusСвойство
public bool SelectAllOnFocus { get; set; }Выделять весь текст при получении фокуса, false по умолчанию. Делегируется внутреннему LineEdit; само переключение настройки не запрашивает фокус.
SuffixСвойство · Устарело
public string Suffix { get; set; }Устаревший суффикс отображения с пробелом после числа. Действует только при пустом Format и вне редактирования. Не часть числового Value.
UpdateOnTextChangedСвойство
public bool UpdateOnTextChanged { get; set; }Применять выражение при TextChanged внутреннего поля через отложенное соединение, false по умолчанию. Программная запись LineEdit.Text не испускает этот сигнал; используйте Apply.
Методы24
Applyvoid
public void Apply();Разбирает текущий текст внутреннего LineEdit как числовое выражение и передаёт результат в Value. Пустой или синтаксически неверный текст сохраняет прежнее число. Вызывайте после программной записи Text; у метода нет результата Error/bool.
GetCustomArrowStepdouble
public double GetCustomArrowStep();Приращение кнопок: 0 использует Step, ненулевое значение — собственный шаг. Не заменяет сетку Range, поэтому выбирайте совместимый шаг. Не пересчитывает текущее Value.
doubleТекущее значение настройки, не подтверждение ввода или визуальной проверки.
GetFormatstring
public string GetFormat();Шаблон sprintf с одним значением для отображения вне редактирования. %s использует стандартное представление по Step, %.2f задаёт две дробные цифры в надписи. Не меняет Value; имеет приоритет над Prefix/Suffix. Неверный шаблон может показать <Invalid>.
stringТекущее значение настройки, не подтверждение ввода или визуальной проверки.
GetFormatAutoTranslateModeEntity.AutoTranslateModeEnum
public Entity.AutoTranslateModeEnum GetFormatAutoTranslateMode();Режим автоматического перевода Format/PluralFormat: Disabled по умолчанию, Always принудительно включает, Inherit учитывает перевод сущности. Сам по себе не добавляет переводов в каталог.
Entity.AutoTranslateModeEnumТекущее значение настройки, не подтверждение ввода или визуальной проверки.
GetHorizontalAlignmentHorizontalAlignment
public HorizontalAlignment GetHorizontalAlignment();Горизонтальное выравнивание текста внутреннего LineEdit, Left по умолчанию. Не меняет положение SpinBox в родительской раскладке.
HorizontalAlignmentТекущее значение настройки, не подтверждение ввода или визуальной проверки.
GetLineEditLineEdit
public LineEdit GetLineEdit();Возвращает общий внутренний LineEdit, которым владеет SpinBox. Не освобождайте и не переносите его. Text — текст редактирования, не гарантированное Value; для программного подтверждения используйте Apply.
LineEditОбщий LineEdit, которым владеет SpinBox; не освобождайте отдельно.
GetPluralFormatstring
public string GetPluralFormat();Шаблон множественной формы для перевода Format. Работает при непустом Format и включённом переводе через FormatAutoTranslateMode; выбор формы использует Value и каталог переводов.
stringТекущее значение настройки, не подтверждение ввода или визуальной проверки.
GetPrefixstring
public string GetPrefix();Устаревший префикс отображения с пробелом перед числом. Действует только при пустом Format и вне редактирования. Для нового кода используйте Format.
stringТекущее значение настройки, не подтверждение ввода или визуальной проверки.
GetSuffixstring
public string GetSuffix();Устаревший суффикс отображения с пробелом после числа. Действует только при пустом Format и вне редактирования. Не часть числового Value.
stringТекущее значение настройки, не подтверждение ввода или визуальной проверки.
GetUpdateOnTextChangedbool
public bool GetUpdateOnTextChanged();Применять выражение при TextChanged внутреннего поля через отложенное соединение, false по умолчанию. Программная запись LineEdit.Text не испускает этот сигнал; используйте Apply.
boolТекущее значение настройки, не подтверждение ввода или визуальной проверки.
IsCustomArrowRoundingbool
public bool IsCustomArrowRounding();Привязывает переход кнопками к сетке CustomArrowStep вместо простого прибавления/вычитания, false по умолчанию. Шаг стрелок должен быть совместим с Step, иначе переход может не изменить Value.
boolТекущее значение настройки, не подтверждение ввода или визуальной проверки.
IsEditablebool
public bool IsEditable();Разрешает пользовательское редактирование внутреннего LineEdit и кнопками, true по умолчанию. Не блокирует программное Value или Apply.
boolТекущее значение настройки, не подтверждение ввода или визуальной проверки.
IsSelectAllOnFocusbool
public bool IsSelectAllOnFocus();Выделять весь текст при получении фокуса, false по умолчанию. Делегируется внутреннему LineEdit; само переключение настройки не запрашивает фокус.
boolТекущее значение настройки, не подтверждение ввода или визуальной проверки.
SetCustomArrowRoundvoid
public void SetCustomArrowRound(bool round);Привязывает переход кнопками к сетке CustomArrowStep вместо простого прибавления/вычитания, false по умолчанию. Шаг стрелок должен быть совместим с Step, иначе переход может не изменить Value.
| Имя | Тип | По умолчанию |
|---|---|---|
round | bool | — |
roundПривязывает переход кнопками к сетке CustomArrowStep вместо простого прибавления/вычитания, false по умолчанию. Шаг стрелок должен быть совместим с Step, иначе переход может не изменить Value.
SetCustomArrowStepvoid
public void SetCustomArrowStep(double arrowStep);Приращение кнопок: 0 использует Step, ненулевое значение — собственный шаг. Не заменяет сетку Range, поэтому выбирайте совместимый шаг. Не пересчитывает текущее Value.
| Имя | Тип | По умолчанию |
|---|---|---|
arrowStep | double | — |
arrowStepПриращение кнопок: 0 использует Step, ненулевое значение — собственный шаг. Не заменяет сетку Range, поэтому выбирайте совместимый шаг. Не пересчитывает текущее Value.
SetEditablevoid
public void SetEditable(bool enabled);Разрешает пользовательское редактирование внутреннего LineEdit и кнопками, true по умолчанию. Не блокирует программное Value или Apply.
| Имя | Тип | По умолчанию |
|---|---|---|
enabled | bool | — |
enabledРазрешает пользовательское редактирование внутреннего LineEdit и кнопками, true по умолчанию. Не блокирует программное Value или Apply.
SetFormatvoid
public void SetFormat(string format);Шаблон sprintf с одним значением для отображения вне редактирования. %s использует стандартное представление по Step, %.2f задаёт две дробные цифры в надписи. Не меняет Value; имеет приоритет над Prefix/Suffix. Неверный шаблон может показать <Invalid>.
| Имя | Тип | По умолчанию |
|---|---|---|
format | string | — |
formatШаблон sprintf с одним значением для отображения вне редактирования. %s использует стандартное представление по Step, %.2f задаёт две дробные цифры в надписи. Не меняет Value; имеет приоритет над Prefix/Suffix. Неверный шаблон может показать <Invalid>.
SetFormatAutoTranslateModevoid
public void SetFormatAutoTranslateMode(Entity.AutoTranslateModeEnum mode);Режим автоматического перевода Format/PluralFormat: Disabled по умолчанию, Always принудительно включает, Inherit учитывает перевод сущности. Сам по себе не добавляет переводов в каталог.
| Имя | Тип | По умолчанию |
|---|---|---|
mode | Entity.AutoTranslateModeEnum | — |
modeРежим автоматического перевода Format/PluralFormat: Disabled по умолчанию, Always принудительно включает, Inherit учитывает перевод сущности. Сам по себе не добавляет переводов в каталог.
SetHorizontalAlignmentvoid
public void SetHorizontalAlignment(HorizontalAlignment alignment);Горизонтальное выравнивание текста внутреннего LineEdit, Left по умолчанию. Не меняет положение SpinBox в родительской раскладке.
| Имя | Тип | По умолчанию |
|---|---|---|
alignment | HorizontalAlignment | — |
alignmentГоризонтальное выравнивание текста внутреннего LineEdit, Left по умолчанию. Не меняет положение SpinBox в родительской раскладке.
SetPluralFormatvoid
public void SetPluralFormat(string format);Шаблон множественной формы для перевода Format. Работает при непустом Format и включённом переводе через FormatAutoTranslateMode; выбор формы использует Value и каталог переводов.
| Имя | Тип | По умолчанию |
|---|---|---|
format | string | — |
formatШаблон множественной формы для перевода Format. Работает при непустом Format и включённом переводе через FormatAutoTranslateMode; выбор формы использует Value и каталог переводов.
SetPrefixvoid
public void SetPrefix(string prefix);Устаревший префикс отображения с пробелом перед числом. Действует только при пустом Format и вне редактирования. Для нового кода используйте Format.
| Имя | Тип | По умолчанию |
|---|---|---|
prefix | string | — |
prefixУстаревший префикс отображения с пробелом перед числом. Действует только при пустом Format и вне редактирования. Для нового кода используйте Format.
SetSelectAllOnFocusvoid
public void SetSelectAllOnFocus(bool enabled);Выделять весь текст при получении фокуса, false по умолчанию. Делегируется внутреннему LineEdit; само переключение настройки не запрашивает фокус.
| Имя | Тип | По умолчанию |
|---|---|---|
enabled | bool | — |
enabledВыделять весь текст при получении фокуса, false по умолчанию. Делегируется внутреннему LineEdit; само переключение настройки не запрашивает фокус.
SetSuffixvoid
public void SetSuffix(string suffix);Устаревший суффикс отображения с пробелом после числа. Действует только при пустом Format и вне редактирования. Не часть числового Value.
| Имя | Тип | По умолчанию |
|---|---|---|
suffix | string | — |
suffixУстаревший суффикс отображения с пробелом после числа. Действует только при пустом Format и вне редактирования. Не часть числового Value.
SetUpdateOnTextChangedvoid
public void SetUpdateOnTextChanged(bool enabled);Применять выражение при TextChanged внутреннего поля через отложенное соединение, false по умолчанию. Программная запись LineEdit.Text не испускает этот сигнал; используйте Apply.
| Имя | Тип | По умолчанию |
|---|---|---|
enabled | bool | — |
enabledПрименять выражение при TextChanged внутреннего поля через отложенное соединение, false по умолчанию. Программная запись LineEdit.Text не испускает этот сигнал; используйте Apply.
Свойства темы
Это ключи ресурсов Theme, а не свойства C# класса. Используйте методы GetTheme…() и AddTheme…Override() у Control с соответствующим типом значения.
| Ключ и тип | Описание |
|---|---|
down_disabled_icon_modulateColor | Цвет модуляции значка кнопки «вниз», когда кнопка отключена. По умолчанию:Color(0.875, 0.875, 0.875, 0.5) |
down_hover_icon_modulateColor | Цвет модуляции значка кнопки «вниз» при наведении на кнопку. По умолчанию:Color(0.95, 0.95, 0.95, 1) |
down_icon_modulateColor | Цвет модуляции значка кнопки «вниз». По умолчанию:Color(0.875, 0.875, 0.875, 1) |
down_pressed_icon_modulateColor | Цвет модуляции значка кнопки «вниз» при нажатии кнопки. По умолчанию:Color(0.95, 0.95, 0.95, 1) |
up_disabled_icon_modulateColor | Цвет модуляции значка кнопки «Вверх», когда кнопка отключена. По умолчанию:Color(0.875, 0.875, 0.875, 0.5) |
up_hover_icon_modulateColor | Цвет модуляции значка кнопки «Вверх» при наведении на кнопку. По умолчанию:Color(0.95, 0.95, 0.95, 1) |
up_icon_modulateColor | Цвет модуляции значка кнопки «Вверх». По умолчанию:Color(0.875, 0.875, 0.875, 1) |
up_pressed_icon_modulateColor | Цвет модуляции значка кнопки «Вверх» при нажатии кнопки. По умолчанию:Color(0.95, 0.95, 0.95, 1) |
buttons_vertical_separationint | Вертикальное разделение между кнопками «вверх» и «вниз». По умолчанию:0 |
buttons_widthint | Ширина кнопок вверх и вниз. Если меньше любого значка, установленного на кнопках, соответствующий значок может перекрывать соседние элементы. Если меньше 16 |
field_and_buttons_separationint | Ширина горизонтального разделения между полем ввода текста ( 2 |
icon_max_widthint | Максимальная допустимая ширина 0 |
set_min_buttons_width_from_iconsint | Если не 1 |
downTexture2D | Значок кнопки «Вниз», отображаемый в середине кнопки «Вниз» (уменьшение значения). |
down_disabledTexture2D | Значок кнопки «Вниз», когда кнопка отключена. |
down_hoverTexture2D | Значок кнопки «Вниз» при наведении на кнопку. |
down_pressedTexture2D | Значок кнопки «Вниз» при нажатии кнопки. |
upTexture2D | Значок кнопки «Вверх», отображаемый в середине кнопки «Вверх» (увеличение значения). |
up_disabledTexture2D | Значок кнопки «Вверх», когда кнопка отключена. |
up_hoverTexture2D | Значок кнопки «Вверх» при наведении на кнопку. |
up_pressedTexture2D | Значок кнопки «Вверх» при нажатии кнопки. |
updownTexture2D | Единая текстура, представляющая значки кнопок «вверх» и «вниз». Она отображается посередине кнопок и не меняется при взаимодействии с ними. Если назначен допустимый значок, он заменит Сосредоточься. |
focus_soundAudioStream | Играл, когда это |
pressed_disabled_soundAudioStream | Воспроизведено при нажатии кнопки вверх или вниз, |
pressed_soundAudioStream | Играет, когда нажимают кнопку вверх или вниз. |
down_backgroundStyleBox | Стиль фона кнопки «вниз». |
down_background_disabledStyleBox | Стиль фона кнопки «вниз» при отключении. |
down_background_hoveredStyleBox | Стиль фона кнопки «вниз» при наведении курсора. |
down_background_pressedStyleBox | Стиль фона кнопки «вниз» при нажатии. |
field_and_buttons_separatorStyleBox |
|
up_backgroundStyleBox | Стиль фона кнопки «вверх». |
up_background_disabledStyleBox | Стиль фона кнопки «вверх» при отключении. |
up_background_hoveredStyleBox | Стиль фона кнопки «вверх» при наведении курсора. |
up_background_pressedStyleBox | Стиль фона кнопки «вверх» при нажатии. |
up_down_buttons_separatorStyleBox |
|