ButtonSpinner 按钮旋转选择器控件
控件名称
ButtonSpinner
中文名称
按钮旋转选择器控件
控件简介
ButtonSpinner 是一个结合数字选择器外观和下拉框选项功能的控件。用户可以通过点击上下按钮或键盘操作来切换选项，适用于需要选择固定选项的场景。
主要特性
- 数字选择器外观：右侧带有上下箭头按钮
- 选项管理：支持添加、删除、清空选项
- 非循环切换：到达边界后停止，不会循环
- 多种操作方式：支持鼠标点击、滚轮、键盘操作
- 自定义外观：支持圆角、颜色、按钮宽度等自定义
- 文本对齐：支持左对齐、居中、右对齐
- 前缀后缀：支持添加前缀/后缀文本和图标
- 水印功能：支持占位符文本显示
- 禁用状态：支持禁用状态显示
重要参数说明
数据属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
Items |
List<object> | - | 子项集合 |
SelectedIndex |
int | -1 | 选中项索引 |
SelectedItem |
object | null | 选中项 |
SelectedText |
string | "" | 选中项的文本显示（只读） |
Text |
string | "" | 选中项的文本（与 SelectedText 关联） |
外观属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
BorderRadius |
int | 5 | 边框圆角半径 |
BorderColor |
Color | Gray | 边框颜色 |
ButtonBackColor |
Color | White | 按钮背景颜色 |
ButtonHoverColor |
Color | 230, 230, 230 | 按钮悬停颜色 |
ButtonPressedColor |
Color | 210, 210, 210 | 按钮按下颜色 |
ArrowColor |
Color | Gray | 箭头颜色 |
ButtonWidth |
int | 30 | 按钮区域宽度 |
文本对齐属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
TextAlign |
HorizontalAlignment | Left | 文本对齐方式（Left/Center/Right） |
前缀后缀属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
PrefixText |
string | "" | 前缀文本 |
PrefixColor |
Color | Gray | 前缀文本颜色 |
PrefixIconSvg |
string | "" | 前缀 SVG 图标 |
SuffixText |
string | "" | 后缀文本 |
SuffixColor |
Color | Gray | 后缀文本颜色 |
SuffixIconSvg |
string | "" | 后缀 SVG 图标 |