Setup Factory for Windows Installer

PushButton Properties

The PushButton control displays a basic push button (or command button).

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

PushButton Type

Text

Show text on the PushButton control (instead of bitmap or icon).

Text:

The localizable text to show on the PushButton control.

Bitmap

Show a bitmap image on the PushButton control (instead of text or icon). The image resource can be selected in the Image: (Binary reference) field below.

Icon

Show an icon image on the PushButton control (instead of text or bitmap). The icon resource can be selected in the Image: (Binary reference) field below.

16x16 - Loads the first 16x16 image from the icon file.

32x32 - Loads the first 32x32 image from the icon file.

48x48 - Loads the first 48x48 image from the icon file.

Image: (Binary reference)

The resource identifier string of the image or icon to use for the control. Select a resource identifier from the dropdown, or click on the New Image button to open the Resource Properties dialog where you can add a new resource to your project. Binary resources can be managed in your project on the Styles dialog (Project > Styles).

Fixed size

If checked, the icon image is cropped to the dimensions of the control. If unchecked the icon image is stretched to fit the control dimensions. The size of the control can be configured on the Attributes tab.

Options

Elevation shield

If checked, the User Account Control (UAC) elevation icon (shield icon) is added to the PushButton control. If unchecked, the other icon attributes are used.

If checked, and the installation is not yet running with elevated privileges, the PushButton control is created using the User Account Control (UAC) elevation icon (shield icon). If the installation is already running with elevated privileges, the PushButton control is created using the other icon attributes.

RTL reading order

If checked, the text in the control will be shown in right-to-left reading order. If unchecked, it will be shown in left-to-right reading order.

More Information

MSDN Online: PushButton Control

MSDN Online: Controls

MSDN Online: Control Table

MSDN Online: Patching and Upgrades

MS TechNet Online: Windows Vista User Account Control Step by Step Guide

WiX Help File: Control Element