Control 表

Control 表定义显示在每个对话框中的控件。

Control 表具有以下列。

列	类型	密钥	Nullable
Dialog_	Identifier	Y	N
控制	Identifier	Y	N
类型	Identifier	N	N
X	整数	N	N
Y	整数	N	N
宽度	整数	N	N
高度	整数	N	N
特性	DoubleInteger	N	Y
属性	Identifier	N	Y
文本	格式化	N	Y
Control_Next	Identifier	N	Y
帮助	文本	N	Y

 

列

Dialog_

Dialog 表第一列的外部键，即对话框的名称。

Control

控件名称。 此名称在对话框中必须具有唯一性，但可以在不同对话框中重复。 Control 列与 Dialog_ 列组合在一起构成了此表的主键。

Type

控件的类型。 有关控件类型的列表，请参阅控件。

X

控件矩形边界左上角的水平坐标。 这必须是非负数。 请参阅 Position 控件属性。

Y

控件矩形边界左上角的垂直坐标。 这必须是非负数。 请参阅 Position 控件属性。

Width

控件矩形边界的宽度。 这必须是非负数。 请参阅 Position 控件属性。

Height

控件矩形边界的高度。 这必须是非负数。 请参阅 Position 控件属性。

Attributes

一个 32 位字，可指定要应用于此控件的位标志。 这必须是非负数，并且允许的值取决于控件类型。 有关所有控件属性的列表以及要在此字段中输入的值，请参阅控件属性。

Property

要链接到此控件的已定义属性的名称。 单选按钮、列表框和组合框值通过链接到同一属性绑定到组。 活动控件需要此列。

Text

一个可本地化的字符串，用于设置控件中包含的初始文本。 该字符串还可以包含嵌入的属性。 有关包含属性的已设置格式的字符串的语法，请参阅 MsiFormatRecord 函数。 通过为文本字符串添加 {\style} 前缀来指定文本的大小、字体和颜色，其中 style 是创作到 TextStyle 表的 TextStyle 列中的文本样式。 如果文本过长而无法在控件上显示，则会截断字符串。 文本字符串可能为空。

如果文本将由位于具有 TrackDiskpace 属性的对话框上的 Text 控件显示，则需要对此字段中的已设置格式的文本字符串进行特殊创作。 这是出现在 Dialog 表的属性中的 TrackDiskSpace Dialog Style 位指定的情况。 在这种情况下，如果 Control 表的 Text 列中的已设置格式字符串以“[”开头，以“]”结尾，则必须在字符串末尾添加空格。 例如，如果 DlgTextFont 是要设置为“{\DlgFontBold}”的属性，则已设置格式字符串“[DlgTextFont]MyText[ProductName]”需要在右括号后的末尾处有空格。 安装程序需要这一额外空间才能正确显示 Text 控件中的文本。

可以为 VolumeCostList、ListView、DirectoryList 和 SelectionTree 控件输入简短的描述性文本字符串。 用户看不到此文本，但屏幕阅读器可以将其作为控件说明进行朗读。

另请参阅辅助功能。

Control_Next

同一对话框中另一个控件的名称，以及 Control 表第二列的外部键。 如果对话框中的焦点位于 Control 列中的控件上，则按 Tab 键会将焦点移动到 Control_Next 列中列出的控件上。 因此，此列用于指定对话框中控件的 Tab 键顺序。 控件之间的链接必须形成封闭的循环。 某些控件（如静态文本控件）可以排除在该循环外。 在这种情况下，此字段可能留空。

另请参阅辅助功能。

帮助

与“帮助”按钮一起使用的可选可本地化文本字符串。 字符串由分隔符 (|) 分为两部分。 字符串的第一部分用作工具提示文本。 屏幕阅读器将此文本用于包含图片的控件。 字符串的第二部分会得到保留，供将来使用。 即使只有两种文本中一种文本存在，也需要分隔符。

备注

x、y、宽度和高度的整数值采用安装程序单位，而不是对话框单位。 安装程序单位等于 10 磅 MS Sans Serif 字号高度的十二分之一。 控件的坐标是相对于标牌而言。

验证

ICE03
ICE06
ICE17
ICE20
ICE23
ICE31
ICE32
ICE34
ICE45
ICE46
ICE95