Windows API Guide: MSGBOXPARAMS Structure

---

The button control's window class describes any type of button control. This includes command buttons, check boxes, and radio boxes. The button class style assigned to a button control determines what type of button it is.

The button control's window class is registered automatically when Windows starts. The name of the class is "BUTTON".

Styles

BS_3STATE

The button is a check box which has three states: checked, grayed, and cleared.

BS_AUTO3STATE

The button is a check box which has three states: checked, grayed, and cleared. The button automatically changes its state when the user selects it.

BS_AUTOCHECKBOX

The button is a check box whose state toggles when the user selects it.

BS_AUTORADIOBUTTON

The button is a radio button whose state automatically changes to selected (and the state of all other radio buttons in the group to unselected) when the user selects it.

BS_BITMAP

The button displays a bitmap.

BS_BOTTOM

The button's text appears at the bottom of the button rectangle.

BS_CENTER

The button's text appears centered horizontally within the button rectangle.

BS_CHECKBOX

The button is a check box.

BS_DEFPUSHBUTTON

The button is the default push button in a dialog box, having a heavy black border.

BS_GROUPBOX

The window is a rectangular grouping frame in which other controls can be grouped.

BS_FLAT

The button is flat, not using the default 3D shading.

BS_ICON

The button displays an icon.

BS_LEFT

The text in the button rectangle is left-justified.

BS_LEFTTEXT, BS_RIGHTBUTTON

The radio or check box's text appears to the left of the button instead of to the right.

BS_MULTILINE

The button's text is wrapped across multiple lines if it cannot fit on a single line.

BS_NOTIFY

The button sends focus notification messages to its parent window.

BS_OWNERDRAW

The owner of the window is responsible for manually drawing it whenever it needs to be redrawn. This window style cannot be combined with any other button styles.

BS_PUSHBUTTON

The button is a push button.

BS_PUSHLIKE

The radio or check button takes on the appearance of a push button. A checked state makes the button look depressed; a cleared state makes the button look normal.

BS_RADIOBUTTON

The button is a radio button.

BS_RIGHT

The text in the button rectangle is right-justified.

BS_TEXT

The button displays text.

BS_TOP

The text appears at the top of the button rectangle.

BS_USERBUTTON

Obsolete; use BS_OWNERDRAW instead.

BS_VCENTER

The text appears centered vertically within the button rectangle.

Constant Definitions

Const BS_3STATE = &H5 Const BS_AUTO3STATE = &H6 Const BS_AUTOCHECKBOX = &H3 Const BS_AUTORADIOBOX = &H9 Const BS_BITMAP = &H80 Const BS_BOTTOM = &H800 Const BS_CENTER = &H300 Const BS_CHECKBOX = &H2 Const BS_DEFPUSHBUTTON = &H1 Const BS_FLAT = &H8000 Const BS_GROUPBOX = &H7 Const BS_ICON = &H40 Const BS_LEFT = &H100 Const BS_LEFTTEXT = &H20 Const BS_MULTILINE = &H2000 Const BS_NOTIFY = &H4000 Const BS_OWNERDRAW = &HB Const BS_PUSHBUTTON = &H0 Const BS_PUSHLIKE = &H1000 Const BS_RADIOBUTTON = &H4 Const BS_RIGHT = &H200 Const BS_RIGHTBUTTON = &H20 Const BS_TEXT = &H0 Const BS_TOP = &H400 Const BS_USERBUTTON = &H8 Const BS_VCENTER = &HC00

Back to the Window Class list.
Back to the Reference section.

---

Last Modified: October 29, 2000
This page is copyright © 2000 Paul Kuliniewicz. Copyright Information Revised October 29, 2000
Go back to the Windows API Guide home page.
E-mail: [e-mail] Send Encrypted E-Mail
This page is at http://www.vbapi.com/ref/other/classes/button.html