VolumeCostList 控件

VolumeCostList 控件提供有关与不同卷上所选内容相关的成本的信息。 该控件显示当前安装中涉及的所有卷以及属性位中指定的类型的所有卷。 如果所需的磁盘空间超过某些驱动器上可用的量,该卷将突出显示在表中。 单击列标题会根据所选列对卷进行排序。

以下字符串用于控件中的列标题,必须在 UIText 表中指定

  • VolumeCostAvailable
  • VolumeCostDifference
  • VolumeCostRequired
  • VolumeCostSize
  • VolumeCostVolume

以下四个本地化字符串用于格式化文件的大小:

  • 字节
  • KB
  • MB
  • GB

作者可以通过在任何字体规范后追加列宽来设置 VolumeCostList 控件中的列宽。 列宽作为一系列正整数输入,用大括号括起来。 空大括号或 {0} 隐藏列。 负数或无法转换为正整数的字符串是无效的列宽。 当序列中遇到无效的列宽时,其余列将被隐藏。 最多可以指定五个列宽。

VolumeCostList 控件控件永远不会显示 控件表的 Text 字段的内容。 相反,此字段指定控件要显示的文本样式,并包含屏幕审阅实用工具使用的控件的说明。 若要设置文本字符串的字体和字体样式,请使用 {\style} 或 {&style} 作为显示字符字符串的前缀。 其中样式是 TextStyle 表的 TextStyle 列中列出的标识符。 如果两者都不存在,但 DefaultUIFont 属性定义为有效的文本样式,将使用该字体。 屏幕评审实用工具将阅读以下信息作为控件的说明。 请参阅 辅助功能

请注意,当用户将其他路径输入到 PathEdit 控件“浏览”对话框DirectoryList 控件DirectoryCombo 控件 时,安装程序不会更新 VolumeCostControl 的内容,因为没有与 VolumeCostList 控件关联的属性。

控件属性

可以将以下属性用于此控件。 若要使用事件更改属性的值,请将控件订阅到 EventMapping 表中的 ControlEvent,并在 Attribute 列中列出属性的标识符。 在事件列中输入 ControlEvent 的标识符。

属性标识符 十六进制位 描述
位置
对话框中控件的位置。
将控件左角的宽度、高度和坐标输入到 控件表的 Width、Height、X 和 Y 列。 使用 安装程序单位 长度和距离。
文本
若要在屏幕阅读器中显示文本,请在 控件表的“文本”列中输入文本。 请参阅 辅助功能
若要在 VolumeCostList 控件中设置列宽,请将列宽追加到任何字体规范。 列宽作为一系列正整数输入,用大括号括起来。 空大括号或 {0} 隐藏列。 负数或无法转换为正整数的字符串是无效的列宽。 当序列中遇到无效的列宽时,其余列将被隐藏。 最多可以指定五个列宽。
可见
0x00000000
0x00000001
隐藏的控件。
可见控件。
将此位包含在 Control 表的 Attributes 列的位词中, 以使控件在创建时可见或隐藏。
还可以使用 ControlCondition 表隐藏或显示控件。
已启用
0x00000000
0x00000002
处于禁用状态的控制。
处于启用状态的控制。
控件 的属性列中将此位包含在位词中,以便在创建时启用控件。
也可以使用 ControlCondition 表启用或禁用控件。
沉没
0x00000000
0x00000004
显示默认视觉样式。
显示具有沉没的 3D 外观的控件。
将这些位包含在 控件表的“属性”列中的位词中。
RTLRO
0x00000000
0x00000020
控件中的文本显示从左到右的阅读顺序。
控件中的文本显示从右到左的阅读顺序。
RightAligned
0x00000000
0x00000040
控件中的文本与左侧对齐。
控件中的文本与右侧对齐。
LeftScroll
0x00000000
0x00000080
滚动条位于控件右侧。
滚动条位于控件左侧。
BiDi
0x000000E0
RTLRORightAlignedLeftScroll 属性的组合设置此值。
RemovableVolume
0x00010000
控制列表可移动驱动器。
包含在 Control 表的“属性”列中的位单词
FixedVolume
0x00020000
控制列表修复了内部硬盘驱动器。
包含在 Control 表的“属性”列中的位单词
RemoteVolume
0x00040000
控制列表远程卷。
包含在 Control 表的“属性”列中的位单词
CDROMVolume
0x00080000
控制 CD-ROM 卷的列表。
包含在 Control 表的“属性”列中的位单词
RAMDiskVolume
0x00100000
控制列表 RAM 磁盘。
包含在 Control 表的“属性”列中的位单词
FloppyVolume
0x00200000
控制列表软盘驱动器。
包含在 Control 表的“属性”列中的位单词
ControlShowRollbackCost
0x00000000
0x00400000
如果 PROMPTROLLBACKCOST = P,并且未设置此属性,则回滚、备份文件不包括在 VolumeCostList 控件显示的成本中。
如果 PROMPTROLLBACKCOST = P,并且设置了此属性,则回滚、备份文件包含在 VolumeCostList 控件显示的成本中。
如果 PROMPTROLLBACKCOST = D 或 F,则忽略此控件属性。如果 PROMPTROLLBACKCOST = F,则包含回滚成本,则包含备份文件。 如果 PROMPTROLLBACKCOST = D,或 DISABLEROLLBACK = 1,则不包括回滚、备份文件的成本。

 

言论

可以使用 CreateWindowEx 函数从 WC_LISTVIEW 类创建此控件。 它具有 LVS_REPORTWS_VSCROLLWS_HSCROLLLVS_SHAREIMAGELISTSLVS_AUTOARRANGELVS_SINGLESELWS_BORDERWS_CHILDWS_TABSTOPWS_GROUP 样式。