SpinEditor¶

SpinEditor — это редактор числовых значений со встроенными кнопками прокрутки, используемыми для увеличения и уменьшения числа на определённое значение (приращение). Пользователь может увеличивать и уменьшать число, щёлкая по этим кнопкам или нажимая клавиши со стрелками «Вверх» и «Вниз» на клавиатуре.

Основные возможности контрола включают:

• Встроенные кнопки прокрутки позволяют пользователю увеличивать и уменьшать значение.
• Ограничение доступного диапазона значений.
• Пользовательское значение приращения.
• Отображение пользовательского префикса и суффикса значения в поле ввода.

Получение и установка значения редактора¶

Используйте свойство SpinEditor.Value, чтобы вернуть и задать числовое значение редактора. Вы также можете использовать для той же цели свойство EditorValue. Эти свойства синхронизированы. Они различаются типом значения: свойство Value имеет тип decimal, тогда как свойство EditorValue имеет тип object, как во всех редакторах Eremex.

Смотрите также: Увеличение и уменьшение значения в коде.

Настройка¶

Следующие основные свойства помогают настроить контрол SpinEditor:

• SpinEditor.Minimum — минимальное значение для редактора.
• SpinEditor.Maximum — максимальное значение для редактора.
• SpinEditor.Increment — значение, на которое увеличивается или уменьшается значение редактора, когда пользователь щёлкает по кнопкам прокрутки или нажимает клавиши со стрелками «Вверх» и «Вниз».
• SpinEditor.ShowEditorButtons — задаёт, отображать ли встроенные кнопки прокрутки.

Пример - как создать SpinEditor¶

Следующий пример инициализирует контрол SpinEditor.

xmlns:mxe="https://schemas.eremexcontrols.net/avalonia/editors"

<mxe:SpinEditor x:Name="SpinEditor" Width="200" 
    Value="7"
    Maximum="15"
    Minimum="1"
    Increment="1"
    />

Префикс и суффикс отображаемого значения¶

Используйте свойства SpinEditor.Prefix и SpinEditor.Suffix, чтобы задать текст, отображаемый до и после числового значения. Пользователи не могут редактировать этот текст.

Пример - как задать префикс и суффикс для значения SpinEditor¶

Следующий пример использует свойства SpinEditor.Prefix и SpinEditor.Suffix, чтобы отобразить текст до и после значения редактора.

xmlns:mxe="https://schemas.eremexcontrols.net/avalonia/editors"

<mxe:SpinEditor x:Name="SpinEditor1" Width="200" 
    Value="8.5"
    Maximum="35"
    Minimum="2"
    Increment="0.5"
    Prefix="V=" Suffix="m/s"
    />

Увеличение и уменьшение значения в коде¶

Команды SpinEditor.IncreaseCommand и SpinEditor.DecreaseCommand увеличивают и уменьшают значение редактора на величину приращения (SpinEditor.Increment).

Вы также можете изменить значение редактора напрямую с помощью свойства SpinEditor.Value.

^* Эта страница переведена с использованием технологий машинного перевода.