列表小组件
“列表小组件”可让您在单列列表视图中显示任何数据集。列表支持以多种不同的方式呈现单个列，包括设置颜色背景和在单元格中呈现图像。您可以通过列表小组件的属性配置基本呈现类型、要查看的列以及状态格式。您可以配置列表，使其显示为简单列表框、组合框、下拉列表框或单选按钮列表。
列表配置
将数据服务链接到列表后，您可以在小组件属性面板中选择要显示的列。
要对数据使用特定呈现器或使用状态格式，请按 ListFormat 属性旁边的“呈现器”和“状态”按钮。对于显示的列，您可以：
• 为单元格选择呈现器 (用于在要显示的数据中处理特定数据类型)。
• 选取样式设置 (固定或状态格式)。
• 如果您要应用固定 (非动态) 样式，请选择“固定样式”，然后选取先前定义的样式定义。如果您要进行动态格式设置 (基于行中返回数据设置颜色背景等)，请选取“基于状态的格式”。
使用“基于状态的格式”，可以基于某一行中的任何列向列表中的该行应用样式。要定义状态格式化程序：
1. 选择格式设置从属的列 (可以是返回数据服务中的任何列)。
2. 选择要用于所显示列的状态定义 (它应该与从属字段的数据类型相匹配)。
3. 接受状态定义的默认值或专门为此列表定义和呈现方式覆盖它们。
组合框
组合框允许您使用提前键入搜索，来缩小下拉列表中的选项列表范围。Multiselect 属性可让您在所有列表项旁边添加复选框 (或使用 CTRL + SHIFT 键)。
下列样式定义可与组合框搭配使用：
• ComboTextboxStyle
• ComboDropdownButtonStyle
属性名称 | 说明 | 基本类型 | 默认值 | 是否可绑定?(Y/N) | 是否可本地化?(Y/N) | ||||
|---|---|---|---|---|---|---|---|---|---|
CustomClass | 用户定义的 CSS 类，应用于小组件顶层 div。可以输入多个类，以空格作为分隔符。 | STRING | 不可用 | Y | N | ||||
ListFormat | ListFormat 属性用于对数据应用特定呈现器，和/或将“固定样式”或“基于状态的格式”应用到显示的数据。 | 不可用 | Renderer and State Value Formatting | N | N | ||||
MultiSelect | 可在列表中选择多个项。会向每个列表项添加复选框。 | BOOLEAN | False | N | N | ||||
AutoSelectFirstRow | 加载数据服务时，自动选择第一行数据。 | BOOLEAN | False | N | N | ||||
查看 | 确定列表类型 (列表、下拉列表、组合框或单选按钮列表)。组合框允许您执行提前键入搜索来缩小列表。 | STRING | 列表 | N | N | ||||
WidthOfDropdownView | 下拉列表视图宽度 (以像素为单位)。小组件的下拉列表部分可以比小组件还宽。 | NUMBER | 110 | N | N | ||||
NumberOfItemsInDropdownView | 在下拉列表视图中时，要在列表中查看的项数。 | NUMBER | 6 | N | N | ||||
NumberOfItemsPerPage | 用于设置“组合框”列表视图中每页显示的项数。 输入一个 ≤ 0 的值以禁用编页。 | NUMBER | 500 | N | N | ||||
TabSequence | 小组件在 Tab 键序列中的索引。 | NUMBER | 0 | N | N | ||||
Alignment | 小组件的对齐方式 (左对齐、右对齐或居中对齐)。 | STRING | 左对齐 | N | N | ||||
LabelAlignment | 标签的对齐方式 (左、右或居中)。 | STRING | 左键 | N | N | ||||
Data | 小组件的数据源。 | INFOTABLE | 不可用 | Y | N | ||||
DisplayField | 表示要显示的数据的信息表字段。 | 不可用 | 不可用 | N | N | ||||
ValueField | 表示值的信息表字段。 | 不可用 | 不可用 | N | N | ||||
EnableKeyboardSelections | 键盘选择已启用。 | BOOLEAN | True | N | N | ||||
TextIfNoSelection | 在列表中未选择任何项时显示的文本。 | STRING | 不可用 | N | Y | ||||
TextIfNoSelectionType | 设置 TextIfNoSelection 属性字段中输入的文本，将其显示为占位符或混搭中的可编辑文本。 | STRING | 可编辑 | N | N | ||||
ClearIfNoSelection | 未选择任何项时将清除 SelectedText。 | BOOLEAN | False | N | N | ||||
DisableSelectedStyle | 禁用选定组合列表项的样式。 | BOOLEAN | False | N | N | ||||
SelectedText | 当前选定的信息表字段值。
| STRING | 不可用 | Y | N | ||||
SelectedItems | 当前选定的信息表字段值。
| INFOTABLE | 不可用 | Y | N | ||||
ListBackgroundStyle | 列表背景的样式。 | STYLEDEFINITION | 不可用 | N | N | ||||
ListItemStyle | 设置下拉列表项的样式。 | STYLEDEFINITION | 不可用 | N | N | ||||
ListItemAlternateStyle | 设置下拉列表中替代行的样式。 | STYLEDEFINITION | 不可用 | N | N | ||||
ListItemHoverStyle | 设置悬停在下拉列表项时的样式。 | STYLEDEFINITION | 不可用 | N | N | ||||
ListItemSelectedStyle | 设置下拉列表中选定项的样式。 | STYLEDEFINITION | 不可用 | N | N | ||||
ListLabelStyle | 设置组合框上方显示的下拉列表标签文本的样式。 | STYLEDEFINITION | 不可用 | N | N | ||||
ListFocusStyle | 文本框具有焦点时的样式。 | STYLEDEFINITION | 不可用 | N | N | ||||
ToolTipStyle | 工具提示启用时的样式。 | STYLEDEFINITION | 不可用 | N | N | ||||
DropdownButtonStyle | 下拉列表按钮样式。 | STYLEDEFINITION | 不可用 | N | N | ||||
DropdownStyle | 下拉控件容器样式。 | STYLEDEFINITION | 不可用 | N | N | ||||
DropdownSelectedStyle | 设置选定项文本颜色的样式。 | STYLEDEFINITION | 不可用 | N | N | ||||
ComboTextboxStyle | 设置组合框的文本框的样式。 | STYLEDEFINITION | 不可用 | N | N | ||||
ComboDropdownButtonStyle | 设置组合框的下拉列表图标的样式。 | STYLEDEFINITION | 不可用 | N | N | ||||
ComboItemHighlightedStyle | 组合列表项突出显示样式。 | STYLEDEFINITION | 不可用 | N | N | ||||
RowHeight | 在运行时每行的高度。 | NUMBER | 28 | N | N | ||||
TextVerticalAlignment | 启用行中文本的垂直对齐。默认值为 30，适用于大小小于 14 px 的字体。对于较大的字体，必须将该值设置为较大的值，以确保在行中完全显示文本。
| NUMBER | 30 | N | N | ||||
DoubleClicked | 事件。DoubleClicked 事件允许您通过单击来选择数据对象，但对另一个事件仍然使用双击，例如，链接双击以触发某个导航链接。 | 不可用 | 不可用 | Y | N | ||||
标签 | 要显示在小组件上的标签。 | STRING | 不可用 | Y | Y |
