ListBoxEx 列表框控件
控件名称
ListBoxEx
中文名称
增强型列表框控件
控件简介
ListBoxEx 是一个功能丰富的列表框控件，支持图标显示、自定义颜色、禁用项、提示文本等特性。适用于需要展示可选择列表项的场景。
主要特性
- 图标支持：每项可设置 SVG 图标，图标颜色与文本颜色一致
- 自定义颜色：每项可单独设置文本颜色
- 禁用项：支持单项禁用，禁用项不可选择
- 提示文本：支持右侧灰色提示文本（类似水印效果）
- 控件禁用：支持整个控件禁用状态
- 滚动支持：项数超出显示区域时自动显示滚动条
- 键盘操作：支持上下方向键选择
- 内边距设置：支持控件级和项级内边距自定义
重要参数说明
数据属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
Items |
List<ListBoxExItem> | - | 项集合 |
SelectedIndex |
int | -1 | 选中项索引 |
SelectedItem |
ListBoxExItem | null | 选中项 |
Text |
string | "" | 选中项的文本 |
外观属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
ItemHeight |
int | 32 | 项高度 |
IconSize |
int | 16 | 图标大小 |
Padding |
Padding | 8,8,8,8 | 控件内边距 |
ItemPadding |
Padding | 8,4,8,4 | 项内边距 |
BorderColor |
Color | 217,217,217 | 边框颜色 |
ItemHoverColor |
Color | 230,247,255 | 项悬停颜色 |
ItemSelectedColor |
Color | 186,231,255 | 项选中颜色 |
DisabledItemColor |
Color | 200,200,200 | 禁用项文本颜色 |
TipTextColor |
Color | 180,180,180 | 提示文本颜色 |
BorderRadius |
int | 4 | 边框圆角 |
ShowBorder |
bool | true | 是否显示边框 |
主题属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
FollowGlobalTheme |
bool | true | 是否跟随全局主题变化 |
ListBoxExItem 项属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
Text |
string | "" | 项文本 |
IconSvg |
string | null | SVG 图标内容 |
Tip |
string | null | 提示文本（右侧灰色显示） |
TextColor |
Color? | null | 文本颜色（null 使用控件 ForeColor） |
Disabled |
bool | false | 是否禁用 |
Tag |
object | null | 关联数据 |