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 控件放在彩色位图的顶部。 如果用户更改显示配色方案,则文本可能不可见。 例如,如果用户出于辅助功能原因设置了高对比度参数,文本可能会变得不可见。