Button Control Styles

These button control styles are available:

BS_AUTOCHECKBOX

An automatic check box automatically toggles its state whenever the user clicks on it.
BS_AUTORADIOBUTTON
When clicked, an automatic radio button automatically checks itself and unchecks all other radio buttons in the same group.
BS_AUTOSIZE
Buttons with this style are sized automatically to make sure the contents fit.

If BS_AUTOSIZE is selected when the button is created, and a -1 is specified for either the parameter of WinCreateWindow, (or when creating the button as a resource) then the button's optimal size is calculated to display the its contents.

BS_AUTO3STATE
An automatic three-state check box automatically toggles its state when the user clicks on it.
BS_BITMAP
Places a bit map instead of text on the push button control. This style works only with the BS_PUSHBUTTON.
BS_CHECKBOX
A check box is a small square with a character string to the right. If it is checked, a small black box appears inside the small square. When the box or string is clicked, by clicking on it with the pointing device or pressing the keyboard spacebar when it is active,
BS_DEFAULT
A BS_DEFAULT pushbutton is one with a thick border box. It has the same properties as a pushbutton. In addition, the user may press a BS_DEFAULT pushbutton by pressing the RETURN or ENTER key. The intention is the same for user-buttons, but the appearance of a BS_DEFAULT userbutton is application defined.

This style can be ORed with the BS_PUSHBUTTON and BS_USERBUTTON styles:

BS_HELP
The button posts a WM_HELP message rather than a WM_COMMAND message.

This style can be ORed with the BS_PUSHBUTTON style.

If both BS_HELP and BS_SYSCOMMAND are set, BS_HELP takes precedence.

BS_ICON
Places an icon instead of text on the push button control. This style works only with the BS_PUSHBUTTON style.
BS_MINIICON
This enables miniicons (half the size of normal icons) to be placed on the push button control.
BS_NOBORDER
The pushbutton is displayed without a border drawn around it. There is no other change in the pushbutton's operation.

This style can be ORed with the BS_PUSHBUTTON style.

BS_NOCURSORSELECT
The radio button does not select itself when given the focus as the result of an arrow key or tab key.

This style can be ORed with the BS_AUTORADIOBUTTON style.

BS_NOPOINTERFOCUS
Buttons with this style do not set the focus to themselves when clicked with the pointing device. This enables the cursor to stay on a control for which information is required, rather than moving to the button. This style has no effect on keyboard interaction. The tab key can still be used as usual to move the focus to the button.

This style can be ORed with any of the basic button styles.

BS_NOTEBOOKBUTTON
A notebook button is identical to a pushbutton except that when it is created as a child of a notebook page it becomes a button in the common button area of the notebook page. If the button is not in a notebook page it will be indistinguishable from a pushbutton.
BS_PUSHBUTTON
A pushbutton is a box that contains a string. When a button is pushed, by clicking the pointing device on it or pressing the spacebar when it is active, the parent window is notified.
BS_RADIOBUTTON
A radio button is similar to a check box, but is typically used in groups in which only one button at a time is checked. When a radio button is clicked or a cursor key is pressed to move within the group, it notifies its owner window. It is then up to the owner window to check the clicked radio button and uncheck all the rest, if necessary.
BS_SYSCOMMAND
The button posts a WM_SYSCOMMAND message rather than a WM_COMMAND message.

This style can be ORed with the BS_PUSHBUTTON style.

If both BS_HELP and BS_SYSCOMMAND are set, BS_HELP takes

BS_TEXT
This enables both text and a bitmap, icon, or miniicon to be placed on the push button control. This style works only with the BS_PUSHBUTTON style, and should be used in conjunction with BS_BITMAP, BS_ICON or BS_MINIICON.
BS_USERBUTTON
This is an application-definable button. The owner window of this style control receives the additional button style BN_PAINT.
BS_3STATE
A three-state check box is identical to a check box control except that its check box can be half-toned as well as the box being checked or unchecked.

When BS_ICON, BS_MINIICON or BS_BITMAP is selected, the image can be activated by specifying the image ID with the button text string. For instance, to load an icon (#define ICON_ID 300), and display it within a button, the button string is set to "#300."

When BS_ICON, BS_MINIICON or BS_BITMAP is selected along with BS_TEXT, the image can still be activated by specifying the following with a zero-terminated text string. format:

"#<image-id>\t<text>"

where:

<image-id>

resource id of the icon, miniicon or bitmap
\t
tab character
<text>
zero-terminated button text string

For example, to load an icon (#define ICON_ID 300) and display it with the button text "My Button," the button string is set to "#300\tMy Button." Notice the "\t" is used to separate the text from the image-id. The image is displayed above the text within the button.

---

[Back: Button Control Window Processing]
[Next: Default Colors]