PushButton Control

Windows Installer

PushButton Control

The PushButton control displays a basic push button, also known as a command button.

PushButton controls cannot be used to publish an IgnoreChange ControlEvent, SelectionDescription ControlEvent, SelectionSize ControlEvent, SelectionPath ControlEvent, SelectionPathOn ControlEvent, SelectionAction ControlEvent, SelectionNoItems ControlEvent, ActionText ControlEvent, ActionData ControlEvent, SetProgress ControlEvent, or TimeRemaining ControlEvent.

You can use the following attributes with this control. To change the value of an attribute using an event, subscribe the control to a ControlEvent in the EventMapping table and list the attribute's identifier in the Attribute column. Enter the identifier of the ControlEvent in the Event column.

Attribute identifier Hexadecimal bit Description
Position Position of control in the dialog box.

Enter the control's width, height, and coordinates of the control's left corner into the Width, Height, X, and Y columns of the Control table. Use installer units for length and distance.

Text This control attribute can specify the text displayed by the control, an image stored in the Binary table, or an image set at run time.

To specify text, enter the text string into the Text column of the Control table. To set the font and font style of a text string, prefix the string of displayed characters with {\style} or {&style}. Where style is an identifier listed in the TextStyle column of the TextStyle table. If neither of these are present, but the DefaultUIFont property is defined as a valid text style, that font will be used.

To specify an icon or bitmap image stored in the Binary table, enter the primary key of the image's record from the Name column of the Binary table into the Text column of the Control table record for the control.

Visible 0x00000000

0x00000001

Hidden control.

Visible control.

Include this bit in the bit word of the Attributes column in the Control table to make the control visible or hidden upon its creation.

You can also hide or show a control by using the ControlCondition table.

Enabled 0x00000000

0x00000002

Control in a disabled state.

Control in an enabled state.

Include this bit in the Attributes column of the Control to enable the control on creation.

You can also enable or disable a control by using the ControlCondition table.

Sunken 0x00000000

0x00000004

Displays the default visual style.

Displays the control with a sunken, 3-D, look.

Include these bits in the bit word in the Attributes column of the Control table.

RTLRO 0x00000000

0x00000020

Text in the control is displayed in left-to-right reading order.

Text in the control is displayed in right-to-left reading order.

Bitmap 0x00000000

0x00040000

Text in the control is specified in the Text column of the Control table.

The button has the BS_BITMAP style, text in the control is replaced by a bitmap image. The Text column in the Control table is used as a foreign key to the Binary table.

Include this bit in the bit word in the Attributes column of the Control.

Do not set the Icon and Bitmap style bits simultaneously. The button cannot contain both a bitmap image and text.

To set the font and font style of a text string, prefix the string of displayed characters with {\style} or {&style}. Where style is an identifier listed in the TextStyle column of the TextStyle table. If neither of these are present, but the DefaultUIFont property is defined as a valid text style, that font will be used.

Icon Control 0x00000000

0x00080000

Text in the control is specified in the Text column of the Control table.

The button has the BS_ICON style, text in the control is replaced by an icon image. The Text column in the Control table is used as a foreign key to the Binary table.

Include this bit in the bit word in the Attributes column of the Control.

Do not set the Icon and Bitmap bits simultaneously. The button cannot contain both an icon image and text.

To set the font and font style of a text string, prefix the string of displayed characters with {\style} or {&style}. Where style is an identifier listed in the TextStyle column of the TextStyle table. If neither of these are present, but the DefaultUIFont property is defined as a valid text style, that font will be used.

FixedSize 0x00000000

0x00100000

Stretch the icon image to fit the control.

Crop or center the icon image in the control.

Include this bit in the bit word of the Attributes column of the BBControl table or the Control table.

IconSize 0x00000000

0x00200000

0x00400000

0x00600000

Loads the first image.

Loads the first 16x16 image.

Loads the first 32x32 image.

Loads the first 48x48 image.

An icon file can contain different size images of the same icon. Include the value of the appropriate bit word in the Attributes column of the Control table

If these bits are not set, the installer ignores the FixedSize attribute and the image is stretched to fit the control rectangle. If both the IconSize bits and the FixedSize bits are set, an image smaller than the control is centered and an image is larger than the control it is reduced to fit.

ElevationShield 0x00000000

0x00800000

The appearance of pushbutton is determined by the other icon attributes.

Adds the User Account Control (UAC) elevation icon (shield icon) to the pushbutton control.

 

Remarks

This control can be created from the BUTTON class by using the CreateWindowEx function. It has the BS_MULTILINE, WS_CHILD, WS_TABSTOP, and WS_GROUP styles.

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.