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 字号高度的十二分之一。 控件的坐标是相对于标牌而言。