PushButton 控件

PushButton 控件显示基本按钮，也称为命令按钮。

PushButton 控件不能用于发布 IgnoreChange ControlEvent、SelectionDescription ControlEvent、SelectionSize ControlEvent、SelectionPath ControlEvent、SelectionPathOn ControlEvent、SelectionAction ControlEvent、SelectionNoItems ControlEvent、ActionText ControlEvent、ActionData ControlEvent、SetProgress ControlEvent 或 TimeRemaining ControlEvent。

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

属性标识符	十六进制位	说明
位置		控件在对话框中的位置。 在 Control 表的 Width、Height、X 和 Y 列中分别输入控件的宽度、高度和控件左角的坐标。 使用安装程序单位表示长度和距离。
文本		此控件属性可以指定控件显示的文本、存储在 Binary 表中的图像或运行时的图像集。 要指定文本，请在 Control 表的 Text 列中输入文本字符串。 若要设置文本字符串的字体和字体样式，请在显示的字符串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 表的 TextStyle 列中列出的标识符。 如果这两者都不存在，但 DefaultUIFont 属性定义为有效的文本样式，则将使用该字体。 若要指定存储在 Binary 表中的图标或位图图像，请将图像记录的主键从 Binary 表的 Name 列输入到控件的 Control 表记录的 Text 列中。
Visible	0x00000000 0x00000001	隐藏的控件。 可见控件。 将此位包含在 Control 表中 Attributes 列的位字中，以使控件在创建时可见或隐藏。 还可使用 ControlCondition 表隐藏或显示控件。
已启用	0x00000000 0x00000002	处于禁用状态的控件。 处于启用状态的控件。 将此位包含在 Control 的 Attributes 列中，以便在创建控件时启用该控件。 还可使用 ControlCondition 表启用或禁用控件。
Sunken	0x00000000 0x00000004	显示默认视觉样式。 显示呈凹陷三维外观的控件。 将这些位包含在 Control 表的 Attributes 列中的位字中。
RTLRO	0x00000000 0x00000020	控件中的文本按从左到右的阅读顺序显示。 控件中的文本按从右到左的阅读顺序显示。
Bitmap	0x00000000 0x00040000	在 Control 表的 Text 列中指定控件中的文本。 按钮具有 BS_BITMAP 样式，控件中的文本将替换为位图图像。 Control 表中的 Text 列用作 Binary 表的外键。 将此位包含在 Control 中 Attributes 列的位字中。 不要同时设置图标和位图样式位。 按钮不能同时包含位图图像和文本。 若要设置文本字符串的字体和字体样式，请在显示的字符串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 表的 TextStyle 列中列出的标识符。 如果这两者都不存在，但 DefaultUIFont 属性定义为有效的文本样式，则将使用该字体。
Icon 控件	0x00000000 0x00080000	在 Control 表的 Text 列中指定控件中的文本。 按钮具有 BS_ICON 样式，控件中的文本将替换为图标图像。 Control 表中的 Text 列用作 Binary 表的外键。 将此位包含在 Control 中 Attributes 列的位字中。 不要同时设置图标位和位图位。 按钮不能同时包含图标图像和文本。 若要设置文本字符串的字体和字体样式，请在显示的字符串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 表的 TextStyle 列中列出的标识符。 如果这两者都不存在，但 DefaultUIFont 属性定义为有效的文本样式，则会使用该字体。
FixedSize	0x00000000 0x00100000	拉伸图标图像以适应控件。 裁剪控件中的图标图像或使其居中显示。 将此位包含在 BBControl 表或 Control 表中 Attributes 列的位字中。
IconSize	0x00000000 0x00200000 0x00400000 0x00600000	加载第一个图像。 加载第一个 16x16 图像。 加载第一个 32x32 图像。 加载第一个 48x48 图像。 图标文件可包含同一图标的不同大小图像。 在 Control 表的 Attributes 列中包含相应位字的值 如果未设置这些位，安装程序将忽略 FixedSize 属性，并且图像将根据控件框大小进行拉伸。 如果同时设置了 IconSize 位和 FixedSize 位，则小于控件的图像居中显示，而大于控件的图像将减小到适合大小。
ElevationShield	0x00000000 0x00800000	按钮的外观由其他图标属性决定。 将 用户帐户控制 (UAC) 提升图标（盾牌图标）添加到 PpushButton 控件。

 

备注

可使用 CreateWindowEx 函数从 BUTTON 类创建此控件。 它具有 BS_MULTILINE、WS_CHILD、WS_TABSTOP 和 WS_GROUP 样式。