reckfellENGINE

SpinBox

Числовое поле с выражениями и кнопками изменения.

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

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.

Range.

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

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

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

Создаёт числовое поле с внутренним LineEdit и таймером кнопок. Step = 1, Editable = true, UpdateOnTextChanged = false; Format пустой.

Свойства11

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

Горизонтальное выравнивание текста внутреннего LineEdit, Left по умолчанию. Не меняет положение SpinBox в родительской раскладке.

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

Привязывает переход кнопками к сетке CustomArrowStep вместо простого прибавления/вычитания, false по умолчанию. Шаг стрелок должен быть совместим с Step, иначе переход может не изменить Value.

CustomArrowStepСвойство
# CustomArrowStep
C#
public double CustomArrowStep { get; set; }

Приращение кнопок: 0 использует Step, ненулевое значение — собственный шаг. Не заменяет сетку Range, поэтому выбирайте совместимый шаг. Не пересчитывает текущее Value.

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

Разрешает пользовательское редактирование внутреннего LineEdit и кнопками, true по умолчанию. Не блокирует программное Value или Apply.

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

Шаблон sprintf с одним значением для отображения вне редактирования. %s использует стандартное представление по Step, %.2f задаёт две дробные цифры в надписи. Не меняет Value; имеет приоритет над Prefix/Suffix. Неверный шаблон может показать <Invalid>.

FormatAutoTranslateModeСвойство
# FormatAutoTranslateMode
C#
public Entity.AutoTranslateModeEnum FormatAutoTranslateMode { get; set; }

Режим автоматического перевода Format/PluralFormat: Disabled по умолчанию, Always принудительно включает, Inherit учитывает перевод сущности. Сам по себе не добавляет переводов в каталог.

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

Шаблон множественной формы для перевода Format. Работает при непустом Format и включённом переводе через FormatAutoTranslateMode; выбор формы использует Value и каталог переводов.

PrefixСвойство · Устарело
# Prefix
C#
public string Prefix { get; set; }

Устаревший префикс отображения с пробелом перед числом. Действует только при пустом Format и вне редактирования. Для нового кода используйте Format.

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

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

SuffixСвойство · Устарело
# Suffix
C#
public string Suffix { get; set; }

Устаревший суффикс отображения с пробелом после числа. Действует только при пустом Format и вне редактирования. Не часть числового Value.

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

Применять выражение при TextChanged внутреннего поля через отложенное соединение, false по умолчанию. Программная запись LineEdit.Text не испускает этот сигнал; используйте Apply.

Методы24

Applyvoid
# Apply
C#
public void Apply();

Разбирает текущий текст внутреннего LineEdit как числовое выражение и передаёт результат в Value. Пустой или синтаксически неверный текст сохраняет прежнее число. Вызывайте после программной записи Text; у метода нет результата Error/bool.

GetCustomArrowStepdouble
# GetCustomArrowStep
C#
public double GetCustomArrowStep();

Приращение кнопок: 0 использует Step, ненулевое значение — собственный шаг. Не заменяет сетку Range, поэтому выбирайте совместимый шаг. Не пересчитывает текущее Value.

Возвращает double

Текущее значение настройки, не подтверждение ввода или визуальной проверки.

GetFormatstring
# GetFormat
C#
public string GetFormat();

Шаблон sprintf с одним значением для отображения вне редактирования. %s использует стандартное представление по Step, %.2f задаёт две дробные цифры в надписи. Не меняет Value; имеет приоритет над Prefix/Suffix. Неверный шаблон может показать <Invalid>.

Возвращает string

Текущее значение настройки, не подтверждение ввода или визуальной проверки.

GetFormatAutoTranslateModeEntity.AutoTranslateModeEnum
# GetFormatAutoTranslateMode
C#
public Entity.AutoTranslateModeEnum GetFormatAutoTranslateMode();

Режим автоматического перевода Format/PluralFormat: Disabled по умолчанию, Always принудительно включает, Inherit учитывает перевод сущности. Сам по себе не добавляет переводов в каталог.

Возвращает Entity.AutoTranslateModeEnum

Текущее значение настройки, не подтверждение ввода или визуальной проверки.

GetHorizontalAlignmentHorizontalAlignment
# GetHorizontalAlignment
C#
public HorizontalAlignment GetHorizontalAlignment();

Горизонтальное выравнивание текста внутреннего LineEdit, Left по умолчанию. Не меняет положение SpinBox в родительской раскладке.

Возвращает HorizontalAlignment

Текущее значение настройки, не подтверждение ввода или визуальной проверки.

GetLineEditLineEdit
# GetLineEdit
C#
public LineEdit GetLineEdit();

Возвращает общий внутренний LineEdit, которым владеет SpinBox. Не освобождайте и не переносите его. Text — текст редактирования, не гарантированное Value; для программного подтверждения используйте Apply.

Возвращает LineEdit

Общий LineEdit, которым владеет SpinBox; не освобождайте отдельно.

GetPluralFormatstring
# GetPluralFormat
C#
public string GetPluralFormat();

Шаблон множественной формы для перевода Format. Работает при непустом Format и включённом переводе через FormatAutoTranslateMode; выбор формы использует Value и каталог переводов.

Возвращает string

Текущее значение настройки, не подтверждение ввода или визуальной проверки.

GetPrefixstring
# GetPrefix
C#
public string GetPrefix();

Устаревший префикс отображения с пробелом перед числом. Действует только при пустом Format и вне редактирования. Для нового кода используйте Format.

Возвращает string

Текущее значение настройки, не подтверждение ввода или визуальной проверки.

GetSuffixstring
# GetSuffix
C#
public string GetSuffix();

Устаревший суффикс отображения с пробелом после числа. Действует только при пустом Format и вне редактирования. Не часть числового Value.

Возвращает string

Текущее значение настройки, не подтверждение ввода или визуальной проверки.

GetUpdateOnTextChangedbool
# GetUpdateOnTextChanged
C#
public bool GetUpdateOnTextChanged();

Применять выражение при TextChanged внутреннего поля через отложенное соединение, false по умолчанию. Программная запись LineEdit.Text не испускает этот сигнал; используйте Apply.

Возвращает bool

Текущее значение настройки, не подтверждение ввода или визуальной проверки.

IsCustomArrowRoundingbool
# IsCustomArrowRounding
C#
public bool IsCustomArrowRounding();

Привязывает переход кнопками к сетке CustomArrowStep вместо простого прибавления/вычитания, false по умолчанию. Шаг стрелок должен быть совместим с Step, иначе переход может не изменить Value.

Возвращает bool

Текущее значение настройки, не подтверждение ввода или визуальной проверки.

IsEditablebool
# IsEditable
C#
public bool IsEditable();

Разрешает пользовательское редактирование внутреннего LineEdit и кнопками, true по умолчанию. Не блокирует программное Value или Apply.

Возвращает bool

Текущее значение настройки, не подтверждение ввода или визуальной проверки.

IsSelectAllOnFocusbool
# IsSelectAllOnFocus
C#
public bool IsSelectAllOnFocus();

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

Возвращает bool

Текущее значение настройки, не подтверждение ввода или визуальной проверки.

SetCustomArrowRoundvoid
# SetCustomArrowRound
C#
public void SetCustomArrowRound(bool round);

Привязывает переход кнопками к сетке CustomArrowStep вместо простого прибавления/вычитания, false по умолчанию. Шаг стрелок должен быть совместим с Step, иначе переход может не изменить Value.

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

Привязывает переход кнопками к сетке CustomArrowStep вместо простого прибавления/вычитания, false по умолчанию. Шаг стрелок должен быть совместим с Step, иначе переход может не изменить Value.

SetCustomArrowStepvoid
# SetCustomArrowStep
C#
public void SetCustomArrowStep(double arrowStep);

Приращение кнопок: 0 использует Step, ненулевое значение — собственный шаг. Не заменяет сетку Range, поэтому выбирайте совместимый шаг. Не пересчитывает текущее Value.

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

Приращение кнопок: 0 использует Step, ненулевое значение — собственный шаг. Не заменяет сетку Range, поэтому выбирайте совместимый шаг. Не пересчитывает текущее Value.

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

Разрешает пользовательское редактирование внутреннего LineEdit и кнопками, true по умолчанию. Не блокирует программное Value или Apply.

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

Разрешает пользовательское редактирование внутреннего LineEdit и кнопками, true по умолчанию. Не блокирует программное Value или Apply.

SetFormatvoid
# SetFormat
C#
public void SetFormat(string format);

Шаблон sprintf с одним значением для отображения вне редактирования. %s использует стандартное представление по Step, %.2f задаёт две дробные цифры в надписи. Не меняет Value; имеет приоритет над Prefix/Suffix. Неверный шаблон может показать <Invalid>.

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

Шаблон sprintf с одним значением для отображения вне редактирования. %s использует стандартное представление по Step, %.2f задаёт две дробные цифры в надписи. Не меняет Value; имеет приоритет над Prefix/Suffix. Неверный шаблон может показать <Invalid>.

SetFormatAutoTranslateModevoid
# SetFormatAutoTranslateMode
C#
public void SetFormatAutoTranslateMode(Entity.AutoTranslateModeEnum mode);

Режим автоматического перевода Format/PluralFormat: Disabled по умолчанию, Always принудительно включает, Inherit учитывает перевод сущности. Сам по себе не добавляет переводов в каталог.

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

Режим автоматического перевода Format/PluralFormat: Disabled по умолчанию, Always принудительно включает, Inherit учитывает перевод сущности. Сам по себе не добавляет переводов в каталог.

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

Горизонтальное выравнивание текста внутреннего LineEdit, Left по умолчанию. Не меняет положение SpinBox в родительской раскладке.

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

Горизонтальное выравнивание текста внутреннего LineEdit, Left по умолчанию. Не меняет положение SpinBox в родительской раскладке.

SetPluralFormatvoid
# SetPluralFormat
C#
public void SetPluralFormat(string format);

Шаблон множественной формы для перевода Format. Работает при непустом Format и включённом переводе через FormatAutoTranslateMode; выбор формы использует Value и каталог переводов.

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

Шаблон множественной формы для перевода Format. Работает при непустом Format и включённом переводе через FormatAutoTranslateMode; выбор формы использует Value и каталог переводов.

SetPrefixvoid
# SetPrefix
C#
public void SetPrefix(string prefix);

Устаревший префикс отображения с пробелом перед числом. Действует только при пустом Format и вне редактирования. Для нового кода используйте Format.

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

Устаревший префикс отображения с пробелом перед числом. Действует только при пустом Format и вне редактирования. Для нового кода используйте Format.

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

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

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

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

SetSuffixvoid
# SetSuffix
C#
public void SetSuffix(string suffix);

Устаревший суффикс отображения с пробелом после числа. Действует только при пустом Format и вне редактирования. Не часть числового Value.

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

Устаревший суффикс отображения с пробелом после числа. Действует только при пустом Format и вне редактирования. Не часть числового Value.

SetUpdateOnTextChangedvoid
# SetUpdateOnTextChanged
C#
public void SetUpdateOnTextChanged(bool enabled);

Применять выражение при TextChanged внутреннего поля через отложенное соединение, false по умолчанию. Программная запись LineEdit.Text не испускает этот сигнал; используйте Apply.

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

Применять выражение при TextChanged внутреннего поля через отложенное соединение, false по умолчанию. Программная запись LineEdit.Text не испускает этот сигнал; используйте Apply.

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

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

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

Цвет модуляции значка кнопки «вниз», когда кнопка отключена.

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

Цвет модуляции значка кнопки «вниз» при наведении на кнопку.

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

Цвет модуляции значка кнопки «вниз».

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

Цвет модуляции значка кнопки «вниз» при нажатии кнопки.

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

Цвет модуляции значка кнопки «Вверх», когда кнопка отключена.

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

Цвет модуляции значка кнопки «Вверх» при наведении на кнопку.

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

Цвет модуляции значка кнопки «Вверх».

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

Цвет модуляции значка кнопки «Вверх» при нажатии кнопки.

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

Вертикальное разделение между кнопками «вверх» и «вниз».

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

Ширина кнопок вверх и вниз. Если меньше любого значка, установленного на кнопках, соответствующий значок может перекрывать соседние элементы. Если меньше 0, ширина автоматически подстраивается под размер значка.

По умолчанию: 16
field_and_buttons_separation
int

Ширина горизонтального разделения между полем ввода текста (LineEdit) и кнопками.

По умолчанию: 2
icon_max_width
int

Максимальная допустимая ширина SpinBoxВысота регулируется в соответствии с соотношением значков.

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

Если не 0, минимальная ширина кнопки соответствует самой широкой из всех иконок, установленных на этих кнопках, даже если SpinBox.buttons_width меньше.

По умолчанию: 1
down
Texture2D

Значок кнопки «Вниз», отображаемый в середине кнопки «Вниз» (уменьшение значения).

down_disabled
Texture2D

Значок кнопки «Вниз», когда кнопка отключена.

down_hover
Texture2D

Значок кнопки «Вниз» при наведении на кнопку.

down_pressed
Texture2D

Значок кнопки «Вниз» при нажатии кнопки.

up
Texture2D

Значок кнопки «Вверх», отображаемый в середине кнопки «Вверх» (увеличение значения).

up_disabled
Texture2D

Значок кнопки «Вверх», когда кнопка отключена.

up_hover
Texture2D

Значок кнопки «Вверх» при наведении на кнопку.

up_pressed
Texture2D

Значок кнопки «Вверх» при нажатии кнопки.

updown
Texture2D

Единая текстура, представляющая значки кнопок «вверх» и «вниз». Она отображается посередине кнопок и не меняется при взаимодействии с ними. Если назначен допустимый значок, он заменит SpinBox.up и SpinBox.down.

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

focus_sound
AudioStream

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

pressed_disabled_sound
AudioStream

Воспроизведено при нажатии кнопки вверх или вниз, SpinBox выключен из-за SpinBox.Editable наличие false.

pressed_sound
AudioStream

Играет, когда нажимают кнопку вверх или вниз.

down_background
StyleBox

Стиль фона кнопки «вниз».

down_background_disabled
StyleBox

Стиль фона кнопки «вниз» при отключении.

down_background_hovered
StyleBox

Стиль фона кнопки «вниз» при наведении курсора.

down_background_pressed
StyleBox

Стиль фона кнопки «вниз» при нажатии.

field_and_buttons_separator
StyleBox

StyleBox рисуется в пространстве, занимаемом разделителем между полем ввода и кнопками.

up_background
StyleBox

Стиль фона кнопки «вверх».

up_background_disabled
StyleBox

Стиль фона кнопки «вверх» при отключении.

up_background_hovered
StyleBox

Стиль фона кнопки «вверх» при наведении курсора.

up_background_pressed
StyleBox

Стиль фона кнопки «вверх» при нажатии.

up_down_buttons_separator
StyleBox

StyleBox рисуется в пространстве, занимаемом разделением между кнопками «вверх» и «вниз».

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

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

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

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