文本控件

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

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

控件属性

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

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

 

言论

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

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