ProgressBar Control

Windows Installer

ProgressBar Control

The ProgressBar control displays a bar graph that changes length as it receives progress messages. This control subscribes to the SetProgress ControlEvent. It can subscribe to a ControlEvent named after the action being monitored.

For related information, see Authoring a ProgressBar Control, and Adding Custom Actions to the ProgressBar.

Control Attributes

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 the 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.

Progress   This attribute specifies how much of the ProgressBar is filled. The attribute is composed of two integers and a string. The first integer field is the current number of progress ticks and the second integer field is the default maximum number of progress ticks (1024). The third field is a string that is the name of the action in progress. If the current number of progress ticks is larger than the maximum, the installer changes it to the maximum.

This attribute is set and changed by the SetProgress ControlEvent. You must subscribe the control to this event in the EventMapping table by entering SetProgress into the Event column and Progress into the Attribute column.

Text Text displayed by the control.

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.

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.

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.

Progress95 0x00000000

0x00010000

Progress bar drawn as a continuous bar.

Progress bar drawn as a series of rectangles.

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

 

Remarks

This control can be created from the PROGRESS_CLASS class by using the CreateWindowEx function. It has the WS_CHILD and WS_GROUP styles.

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.