Text Control

Text 控件显示静态文本，可能使用预定义样式。

显示具有指定换行符的文本的建议方法是，使用位于彼此下方的多个单行文本控件。 控件的文本字段中的字符序列 \n、\r\n 或 \n\r 不会显示为换行符。 这些字符序列由控件按字面方式显示。

控件属性

可将以下属性与 Text 控件一起使用。 若要使用事件更改属性的值，请在 EventMapping 表中将该控件订阅到一个 ControlEvent，并在 Attribute 列中列出该属性的标识符。 在 Event 列中输入 ControlEvent 的标识符。

属性标识符	十六进制位	说明
位置		控件在对话框中的位置。 在 Control 表或 BBControl 表的 Width、Height、X 和 Y 列中分别输入控件的宽度、高度和控件左角的坐标。 使用安装程序单位表示长度和距离。
文本		控件显示的文本。 若要设置文本字符串的字体和字体样式，请在显示的字符串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 表的 TextStyle 列中列出的标识符。 如果这两者都不存在，但 DefaultUIFont 属性定义为有效的文本样式，则会使用该字体。
TimeRemaining		此属性使 Text 控件能够显示安装剩余的估算分钟数和秒数。 将 Text 控件订阅到 Eventmapping 表中的 TimeRemaining ControlEvent，并将 TimeRemaining 输入到 Attribute 列中。 安装程序会发布一条记录，其中包含一个整数，表示安装中剩余的秒数。 在 UIText 表中包括一行，并在 Key 列中包含 TimeRemaining。 在创作的 Text 列中输入格式化文本字符串，以显示分钟和秒。 设置此字符串的格式，如 MsiFormatRecord 中所述。
Visible	0x00000000 0x00000001	隐藏的控件。 可见控件。 将此位包含在 Control 表或 BBControl 表中 Attributes 列的位字中，使控件在创建时可见或隐藏。 还可使用 ControlCondition 表隐藏或显示控件。
已启用	0x00000000 0x00000002	处于禁用状态的控件。 处于启用状态的控件。 将位字中的此位包含在 Control 或 BBControl 表的 Attributes 列中，以便在创建控件时启用该控件。 还可使用 ControlCondition 表启用或禁用控件。
Sunken	0x00000000 0x00000004	显示默认视觉样式。 显示呈凹陷三维外观的控件。 将这些位包含在 Control 表的 Attributes 列中的位字中。
RTLRO	0x00000000 0x00000020	控件中的文本按从左到右的阅读顺序显示。 控件中的文本按从右到左的阅读顺序显示。
RightAligned	0x00000000 0x00000040	控件中的文本向左对齐。 控件中的文本向右对齐。
透明	0x00000000 0x00010000	不透明控件。 背景通过控件显示。 控件具有 WS_EX_TRANSPARENT 样式。 将此位包含在 Control 或 BBControl 表中的 Attributes 列的位字中。
NoPrefix	0x00000000 0x00020000	在文本字符串中使用 & 可将下一个字符显示为带下划线的字符。 字符串中的字符 & 显示为自身。 将此位包含在 Control 或 BBControl 表中 Attributes 列的位字中。
NoWrap	0x00000000 0x00040000	文本换行。 文本显示在单行上。 如果文本超出控件的边距，则会对其进行剪裁，并插入省略号（“...”）。 将此位包含在 Control 或 BBControl 表中 Attributes 列的位字中。
UsersLanguage	0x00000000 0x00100000	在数据库代码页中创建的字体。 在用户的默认 UI 代码页中创建的字体。
FormatSize 控件属性	0x00000000 0x00080000	格式化为文本。 如果设置了此位，控件会尝试将显示的文本格式化为表示字节计数的数字。 为了正确设置格式，必须将控件的文本设置为表示以 512 字节为单位的数字的字符串。 然后，显示的值将采用千字节 (KB)、兆字节 (MB) 或千兆字节 (GB) 的格式，并使用表示单位的适当字符串显示。

 

备注

可使用 CreateWindowEx 函数从 STATIC 类创建此控件。 此控件具有 SS_LEFT、WS_CHILD 和 WS_GROUP 样式。

不要将透明 Text 控件放在彩色位图的顶部。 如果用户更改显示配色方案，则文本可能不可见。 例如，如果用户出于辅助功能原因设置了高对比度参数，文本可能会变得不可见。