Slider
Базовое поведение горизонтального и вертикального ползунка.
Используйте HSlider или VSlider. Число хранится в унаследованном Value, диапазон — в MinValue/MaxValue, шаг числовой сетки — в Step. TickCount и TicksPosition настраивают только изображение делений: они не привязывают Value к отметкам. Чтобы разрешить дробные значения без сетки, задайте Step = 0 и Rounded = false.
Editable = false запрещает пользовательский ввод, но оставляет программную запись Value. Scrollable = false отключает колесо, сохраняя остальные разрешённые способы ввода. Колесо использует Step; окончательное значение проходит правила Range.
DragStarted/DragEnded относятся к перетаскиванию мышью. Программная запись Value их не вызывает. Аргумент valueChanged у DragEnded сравнивает нормализованное положение в начале и конце: перемещение с возвратом в исходное положение может дать false. Для обычной реакции на значение используйте ValueChanged с учётом исключений Range.
TickCount = 0 по умолчанию; при количестве меньше двух деления не рисуются. TicksOnBorders определяет наличие крайних отметок; промежуточные деления размещаются равномерно, а не по Step. Для горизонтального ползунка направление учитывает RTL, у вертикального большее значение находится выше.
Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.
Свойства5
EditableСвойство
public bool Editable { get; set; }Разрешает пользовательский ввод, true по умолчанию. false отключает действия пользователя и сбрасывает активный drag; программная запись Value остаётся доступной.
ScrollableСвойство
public bool Scrollable { get; set; }Разрешает изменение колесом мыши, true по умолчанию. false не запрещает drag, клавиши или программную запись. При Editable = false ввод всё равно заблокирован.
TickCountСвойство
public int TickCount { get; set; }Количество равномерных делений, 0 по умолчанию. Меньше двух не рисуется. Не задаёт Step и не ограничивает Value; TicksOnBorders отдельно управляет крайними отметками.
TicksOnBordersСвойство
public bool TicksOnBorders { get; set; }Рисовать крайние деления, false по умолчанию. При TickCount = 2 и false обе отметки пропускаются. На границы Range и шаг это не влияет.
TicksPositionСвойство
public Slider.TickPosition TicksPosition { get; set; }Расположение отметок: BottomRight, TopLeft, Both или Center. По умолчанию BottomRight. Управляет рисунком, а не значением или числом делений.
Методы10
GetTicksint
public int GetTicks();Количество равномерных делений, 0 по умолчанию. Меньше двух не рисуется. Не задаёт Step и не ограничивает Value; TicksOnBorders отдельно управляет крайними отметками.
intТекущее значение настройки, не подтверждение ввода или визуальной проверки.
GetTicksOnBordersbool
public bool GetTicksOnBorders();Рисовать крайние деления, false по умолчанию. При TickCount = 2 и false обе отметки пропускаются. На границы Range и шаг это не влияет.
boolТекущее значение настройки, не подтверждение ввода или визуальной проверки.
GetTicksPositionSlider.TickPosition
public Slider.TickPosition GetTicksPosition();Расположение отметок: BottomRight, TopLeft, Both или Center. По умолчанию BottomRight. Управляет рисунком, а не значением или числом делений.
Slider.TickPositionТекущее значение настройки, не подтверждение ввода или визуальной проверки.
IsEditablebool
public bool IsEditable();Разрешает пользовательский ввод, true по умолчанию. false отключает действия пользователя и сбрасывает активный drag; программная запись Value остаётся доступной.
boolТекущее значение настройки, не подтверждение ввода или визуальной проверки.
IsScrollablebool
public bool IsScrollable();Разрешает изменение колесом мыши, true по умолчанию. false не запрещает drag, клавиши или программную запись. При Editable = false ввод всё равно заблокирован.
boolТекущее значение настройки, не подтверждение ввода или визуальной проверки.
SetEditablevoid
public void SetEditable(bool editable);Разрешает пользовательский ввод, true по умолчанию. false отключает действия пользователя и сбрасывает активный drag; программная запись Value остаётся доступной.
| Имя | Тип | По умолчанию |
|---|---|---|
editable | bool | — |
editableРазрешает пользовательский ввод, true по умолчанию. false отключает действия пользователя и сбрасывает активный drag; программная запись Value остаётся доступной.
SetScrollablevoid
public void SetScrollable(bool scrollable);Разрешает изменение колесом мыши, true по умолчанию. false не запрещает drag, клавиши или программную запись. При Editable = false ввод всё равно заблокирован.
| Имя | Тип | По умолчанию |
|---|---|---|
scrollable | bool | — |
scrollableРазрешает изменение колесом мыши, true по умолчанию. false не запрещает drag, клавиши или программную запись. При Editable = false ввод всё равно заблокирован.
SetTicksvoid
public void SetTicks(int count);Количество равномерных делений, 0 по умолчанию. Меньше двух не рисуется. Не задаёт Step и не ограничивает Value; TicksOnBorders отдельно управляет крайними отметками.
| Имя | Тип | По умолчанию |
|---|---|---|
count | int | — |
countКоличество равномерных делений, 0 по умолчанию. Меньше двух не рисуется. Не задаёт Step и не ограничивает Value; TicksOnBorders отдельно управляет крайними отметками.
SetTicksOnBordersvoid
public void SetTicksOnBorders(bool ticksOnBorder);Рисовать крайние деления, false по умолчанию. При TickCount = 2 и false обе отметки пропускаются. На границы Range и шаг это не влияет.
| Имя | Тип | По умолчанию |
|---|---|---|
ticksOnBorder | bool | — |
ticksOnBorderРисовать крайние деления, false по умолчанию. При TickCount = 2 и false обе отметки пропускаются. На границы Range и шаг это не влияет.
SetTicksPositionvoid
public void SetTicksPosition(Slider.TickPosition ticksOnBorder);Расположение отметок: BottomRight, TopLeft, Both или Center. По умолчанию BottomRight. Управляет рисунком, а не значением или числом делений.
| Имя | Тип | По умолчанию |
|---|---|---|
ticksOnBorder | Slider.TickPosition | — |
ticksOnBorderПоложение отметок Slider.TickPosition. Имя параметра ticksOnBorder не означает bool.
Сигналы и события2
DragEndedСобытие
public event Slider.DragEndedEventHandler DragEnded;Завершение drag. valueChanged сравнивает нормализованное положение в начале и конце, а не наличие любого движения по пути. Программная запись Value этот сигнал не испускает.
| Имя | Тип | По умолчанию |
|---|---|---|
valueChanged | bool | — |
valueChangedtrue, если нормализованное положение в конце отличается от начального; это не признак любого промежуточного движения.
DragStartedСобытие
public event Action DragStarted;Начало перетаскивания мышью. Обычная запись Value и работа колеса не составляют эту пару drag-сигналов. Для значений используйте ValueChanged.
Slider.TickPosition
| Значение | Описание |
|---|---|
Both = 2 | Устанавливает галочки по обеим сторонам ползунка. |
BottomRight = 0 | |
Center = 3 | Размещает галочки в центре ползунка. |
TopLeft = 1 | Размещает галочки в верхней части |
Свойства темы
Это ключи ресурсов Theme, а не свойства C# класса. Используйте методы GetTheme…() и AddTheme…Override() у Control с соответствующим типом значения.
| Ключ и тип | Описание |
|---|---|
center_grabberint | Булева константа. Если 0 |
grabber_max_sizeint | Максимальный допустимый размер 0 |
grabber_offsetint | Вертикальное или горизонтальное смещение захвата. По умолчанию:0 |
tick_max_sizeint | Максимальный допустимый размер 0 |
tick_offsetint | Вертикальное или горизонтальное смещение делений. Смещение обратное для верхних или левых делений. По умолчанию:0 |
grabberTexture2D | Текстура для захвата (перетаскиваемого элемента). |
grabber_disabledTexture2D | Текстура для граббера, когда он отключен. |
grabber_highlightTexture2D | Текстура для захвата, когда он сфокусирован. |
tickTexture2D | Текстура для тактов, видимая, когда |
drag_ended_soundAudioStream | Проигрывается, когда мышь или прикосновение заканчиваются. |
drag_started_soundAudioStream | Играет, когда начинается мышь или прикосновение. Это также используется Сосредоточься. |
focus_soundAudioStream | Играл, когда это |
value_change_rejected_soundAudioStream | Проигрывается, когда значение пытается изменить с помощью клавиатуры или геймпада, но это значение уже является минимальным (или максимальным). |
value_changed_soundAudioStream | Воспроизводится, когда значение изменяется через клавиатуру или вход в игровую папку. Если значение уже находится на минимальном (или максимальном) уровне, [Вместо этого используется тема_позиция_изменение_отклонение_звук]. |
grabber_areaStyleBox | Фон области слева или снизу от граббера. |
grabber_area_highlightStyleBox | Фон области слева или снизу от захвата, который отображается при наведении на него курсора или фокусировке. |
sliderStyleBox | Фон для всего слайдера. Влияет на высоту или ширину |