Other Window Styles for Button Controls

InstallShield 2016

Project • This information applies to the following project types:

•

InstallScript

•

InstallScript MSI

•

InstallScript Object

The following window style options are available for button controls (check box, radio button group, push button, and group box controls). For additional information, see the MSDN Library.

Window Styles for Button Controls
Value	Description
WS_GROUP	Specifies the first control in a group of controls. All controls defined with this style after the first control belong to the same group.
BS_LEFTTEXT	Places text on the left side of the radio button or check box when combined with a radio button or check box style.
BS_CENTER	Centers text horizontally in the button rectangle.
BS_BOTTOM	Places text at the bottom of the button rectangle.
WS_VSCROLL	Creates a window with a vertical scroll bar.
BS_VCENTER	Places text in the middle (vertically) of the button rectangle.
BS_PUSHLIKE	Makes a button—such as a check box, three-state check box, or radio button—look and act like a push button. The button looks raised when it is not pushed or selected, and sunken when it is pushed or checked.
BS_FLAT	Specifies that the button is two-dimensional. It does not use the default shading to create a three-dimensional image.
BS_NOTIFY	Enables a button to send BN_KILLFOCUS and BN_SETFOCUS notification messages to its parent window. Buttons send the BN_CLICKED notification message regardless of whether it has this style. To get BN_DBLCLK notification messages, the button must have the BS_RADIOBUTTON or BS_OWNERDRAW style.
BS_MULTILINE	Wraps the button text to multiple lines if the text string is too long to fit on a single line in the button rectangle.

Other Window Styles for Push Button Controls

The following values apply only to push button controls. They are mutually exclusive.

Window Styles for Push Button Controls
Value	Description
BS_OWNERDRAW	Creates an owner-drawn button. The owner window receives a WM_DRAWITEM message when a visual aspect of the button has changed. Do not combine the BS_OWNERDRAW style with any other button styles.
BS_USERBUTTON	Obsolete, but provided for compatibility with 16-bit versions of Windows. Win32-based applications should use BS_OWNERDRAW instead.

Other Window Styles for Check Box Controls

The following values apply only to check box controls. They are mutually exclusive.

Window Styles for Check Box Controls
Value	Description
BS_AUTOCHECKBOX	Creates a button that is the same as a check box, except that the check state automatically toggles between checked and cleared each time the user selects the check box.
BS_3STATE	Creates a button that is the same as a check box, except that the box can be grayed as well as checked or cleared. Use the grayed state to show that the state of the check box is not determined.
BS_AUTO3STATE	Creates a button that is the same as a three-state check box, except that the box changes its state when the user selects it. The state cycles through checked, grayed, and cleared.

Other Window Styles for Button Controls

InstallShield 2016 Help Library

August 2016