ListView 控件
ListView 控件显示单个值列,并在每个项旁边显示一个图标。 用户可以使用此控件从预先确定的列表中为属性选择单个字符串或整数值。 可能的值是从 ListView 表读取的。 可以通过在 Control 表的 Property 列中输入属性名称,将该控件与某个整数或字符串值相关联。
ListView 控件永远不会显示 Control 表的 Text 字段的内容。 此字段指定控件要显示的文本样式,并包含屏幕查看实用工具所用控件的说明。 若要设置文本字符串的字体和字体样式,请在显示的字符串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 表的 TextStyle 列中列出的标识符。 如果这两者都不存在,但 DefaultUIFont 属性定义为有效的文本样式,则会使用该字体。 屏幕查看实用工具会将其下信息读取为控件的说明。 请参阅辅助功能。
控件属性
可将以下属性与此控件一起使用。 若要使用事件更改属性的值,请将控件订阅到 EventMapping 表中的 ControlEvent,并在 Attribute 列中列出该属性的标识符。 在 Event 列中输入 ControlEvent 的标识符。
属性标识符 | 十六进制位 | 说明 |
---|---|---|
IndirectPropertyName | 这是与控件关联的 Indirect 属性的名称。 如果设置了 Indirect 属性位,控件将显示或更改具有此名称的属性的值。 如果设置了 Indirect 属性位,此名称也是 Control 表的 Property 列中列出的属性的值。 | |
位置 | 控件在对话框中的位置。 在 Control 表的 Width、Height、X 和 Y 列中分别输入控件的宽度、高度和控件左角的坐标。 使用安装程序单位表示长度和距离。 |
|
PropertyName | 这是与此控件关联的属性的名称。 如果未设置 Indirect 属性位,控件将显示或更改具有此名称的属性的值。 此属性在 Control 表的 Property 列中指定。 | |
PropertyValue | 此控件显示或更改的属性的当前值。 如果未设置 Indirect 属性位,则这是 PropertyName 的值。 如果设置了 Indirect 属性位,则这是 IndirectPropertyName 的值。 如果属性发生更改,控件将反映新值。 | |
文本 | 若要在屏幕阅读器中显示文本,请在 Control 表的 Text 列中输入文本。 请参阅辅助功能。 | |
Visible | 0x00000000 0x00000001 |
隐藏的控件。 可见控件。 将此位包含在 Control 表中 Attributes 列的位字中,以使控件在创建时可见或隐藏。 还可使用 ControlCondition 表隐藏或显示控件。 |
已启用 | 0x00000000 0x00000002 |
处于禁用状态的控件。 处于启用状态的控件。 将此位包含在 Control 的 Attributes 列中的位字中,以在创建控件时启用该控件。 还可使用 ControlCondition 表启用或禁用控件。 |
Sunken | 0x00000000 0x00000004 |
显示默认视觉样式。 显示呈凹陷三维外观的控件。 将这些位包含在 Control 表的 Attributes 列中的位字中。 |
间接 | 0x00000000 0x00000008 |
控件显示或更改 Control 表的 Property 列中的属性的值。 控件显示或更改 Control 表的 Property 列中列出了其标识符的属性的值。 确定是否间接引用与此控件关联的属性。 |
整数 | 0x00000000 0x00000010 |
与控件关联的属性是一个字符串值。 与控件关联的属性是一个整数值。 在 Control 表的 Attributes 列的位字中包括此位,以便在创建控件时设置此属性。 |
RTLRO | 0x00000000 0x00000020 |
控件中的文本按从左到右的阅读顺序显示。 控件中的文本按从右到左的阅读顺序显示。 |
RightAligned | 0x00000000 0x00000040 |
控件中的文本向左对齐。 控件中的文本向右对齐。 |
LeftScroll | 0x00000000 0x00000080 |
滚动条位于控件的右侧。 滚动条位于控件的左侧。 |
BiDi | 0x000000E0 | 针对 RTLRO、RightAligned 和 LeftScroll 属性的组合设置此值。 |
Sorted | 0x00000000 0x00010000 |
按字母顺序显示的项。 按 ListView 表中指定的顺序显示的项。 将此位包含在 Attributes 列的位字中可按 ListView 表的 Order 列指定的顺序显示项。 |
FixedSize | 0x00000000 0x00100000 |
根据控件大小拉伸图标图像。 裁剪控件中的图标图像或使其居中显示。 将此位包含在 Control 表中 Attributes 列的位字中。 |
IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
加载第一个图像。 加载第一个 16x16 图像。 加载第一个 32x32 图像。 加载第一个 48x48 图像。 图标文件可包含同一图标的不同大小图像。 在 Control 表的 Attributes 列中包含相应位字的值 如果未设置这些位,安装程序将忽略 FixedSize 属性,并且图像将根据控件框大小进行拉伸。 如果同时设置了 IconSize 位和 FixedSize 位,则小于控件的图像居中显示,而大于控件的图像将进行收缩。 |
备注
可使用 CreateWindowEx 函数通过 WC_LISTVIEW 类创建此控件。 它具有 LVS_REPORT、LVS_NOCOLUMNHEADER、WS_VSCROLL、WS_HSCROLL、LVS_SHAREIMAGELISTS、LVS_SINGLESEL、LVS_SHOWSELALWAYS、WS_BORDER 和 WS_TABSTOP 样式。 如果 Sorted 样式位未打开,则该控件还具有 LVS_SORTASCENDING 样式。
为了与屏幕阅读器兼容,在使用 ListView 控件作为第一个活动控件创建对话框时,必须使属于编辑字段的文本字段成为 Dialog 表中的第一个活动控件。 由于静态文本无法聚焦,因此在创建对话框时,编辑字段最初将按预期聚焦,但这样可确保屏幕阅读器显示正确的信息。