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
针对 RTLRORightAlignedLeftScroll 属性的组合设置此值。
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 样式。