VolumeCostList 控件
VolumeCostList 控件显示选择不同卷时与之关联的成本信息。 控件显示当前安装所涉及的所有卷,以及属性位中所指定类型的所有卷。 如果所需磁盘空间超出某些驱动器上的可用空间量,则表中会突出显示该卷。 单击列标题会根据所选列对卷进行排序。
该控件的列标题使用以下字符串,必须在 UIText 表中指定这些字符串:
- VolumeCostAvailable
- VolumeCostDifference
- VolumeCostRequired
- VolumeCostSize
- VolumeCostVolume
在设置文件大小的格式时,会使用以下四个本地化字符串:
- 字节
- KB
- MB
- GB
作者可以通过在任何字体规范后面追加列宽来设置 VolumeCostList 控件的列宽。 列宽以括在大括号中的一系列正整数的形式输入。 空大括号或 {0} 则隐藏列。 负数或不能转换为正整数的字符串是无效列宽。 序列中出现无效列宽时,剩余列都会隐藏。 最多可以指定五个列宽。
VolumeCostList 控件永远不会显示 Control 表 的 Text 字段的内容。 相反,此字段指定控件要显示的文本样式,并包含屏幕查看实用工具所用控件的说明。 若要设置文本字符串的字体和字体样式,请在显示的字符串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 表的 TextStyle 列中列出的标识符。 如果这两者都不存在,但 DefaultUIFont 属性定义为有效的文本样式,则会使用该字体。 屏幕查看实用工具会将其下信息读取为控件的说明。 请参阅辅助功能。
请注意,当用户在 PathEdit 控件、浏览对话框、DirectoryList 控件或 DirectoryCombo 控件中输入不同路径时,安装程序不会更新 VolumeCostControl 的内容,因为没有与 VolumeCostList 控件关联的属性。
控件属性
可将以下属性与此控件一起使用。 若要使用事件更改属性的值,请将控件订阅到 EventMapping 表中的 ControlEvent,并在 Attribute 列中列出该属性的标识符。 在 Event 列中输入 ControlEvent 的标识符。
属性标识符 | 十六进制位 | 说明 |
---|---|---|
位置 |
控件在对话框中的位置。 在 Control 表的 Width、Height、X 和 Y 列中分别输入控件的宽度、高度和控件左角的坐标。 使用安装程序单位表示长度和距离。 |
|
文本 |
若要在屏幕阅读器中显示文本,请在 Control 表的 Text 列中输入文本。 请参阅辅助功能。 若要设置 VolumeCostList 控件的列宽,请在任何字体规范后追加列宽。 列宽以括在大括号中的一系列正整数的形式输入。 空大括号或 {0} 则隐藏列。 负数或不能转换为正整数的字符串是无效列宽。 序列中出现无效列宽时,剩余列都会隐藏。 最多可以指定五个列宽。 |
|
Visible |
0x00000000 0x00000001 |
隐藏控件。 可见控件。 将此位包含在 Control 表中 Attributes 列的位字中,以使控件在创建时可见或隐藏。 还可使用 ControlCondition 表隐藏或显示控件。 |
已启用 |
0x00000000 0x00000002 |
处于禁用状态的控件。 处于启用状态的控件。 将此位包含在 Control 的 Attributes 列中的位字中,以在创建控件时启用该控件。 还可使用 ControlCondition 表启用或禁用控件。 |
Sunken |
0x00000000 0x00000004 |
显示默认视觉样式。 显示呈凹陷三维外观的控件。 将这些位包含在 Control 表的 Attributes 列中的位字中。 |
RTLRO |
0x00000000 0x00000020 |
控件中的文本按从左到右的阅读顺序显示。 控件中的文本按从右到左的阅读顺序显示。 |
RightAligned |
0x00000000 0x00000040 |
控件中的文本左对齐。 控件中的文本向右对齐。 |
LeftScroll |
0x00000000 0x00000080 |
滚动条位于控件的右侧。 滚动条位于控件的左侧。 |
BiDi |
0x000000E0 |
针对 RTLRO、RightAligned 和 LeftScroll 属性的组合设置此值。 |
RemovableVolume |
0x00010000 |
控件列出可移动驱动器。 包含在 Control 表中 Attributes 列的位字中。 |
FixedVolume |
0x00020000 |
控件列出固定的内部硬盘驱动器。 包含在 Control 表中 Attributes 列的位字中。 |
RemoteVolume |
0x00040000 |
控件列出远程卷。 包含在 Control 表中 Attributes 列的位字中。 |
CDROMVolume |
0x00080000 |
控件列出 CD-ROM 卷。 包含在 Control 表中 Attributes 列的位字中。 |
RAMDiskVolume |
0x00100000 |
控制列出 RAM 磁盘。 包含在 Control 表中 Attributes 列的位字中。 |
FloppyVolume |
0x00200000 |
控件列出软盘驱动器。 包含在 Control 表中 Attributes 列的位字中。 |
ControlShowRollbackCost |
0x00000000 0x00400000 |
如果 PROMPTROLLBACKCOST 为 P,且未设置此属性,则 VolumeCostList 控件显示的成本中不包括回滚、备份文件。 如果 PROMPTROLLBACKCOST 为 P,且设置了此属性,则 VolumeCostList 控件显示的成本中包括回滚、备份文件。 如果 PROMPTROLLBACKCOST 为 D 或 F,则忽略此控件属性。如果 PROMPTROLLBACKCOST 为 F,则包括回滚、备份文件的成本。 如果 PROMPTROLLBACKCOST 为 D 或 DISABLEROLLBACK 为 1,则不包括回滚、备份文件的成本。 |
备注
可使用 CreateWindowEx 函数通过 WC_LISTVIEW 类创建此控件。 该控件具有 LVS_REPORT、WS_VSCROLL、WS_HSCROLL、LVS_SHAREIMAGELISTS、LVS_AUTOARRANGE、LVS_SINGLESEL、WS_BORDER、WS_CHILD、WS_TABSTOP 和 WS_GROUP 样式。