BUTTON control styles



The control is a 3-state checkbox control that automatically updates itself when clicked/toggled. Do not use with the %BS_DEFAULT or %BS_DEFPUSHBUTTON styles.


The control is a checkbox control that automatically updates itself when clicked/toggled.


Place the text at the bottom edge of the button.


Center the text horizontally in the button. (default)


Create a button with a heavy black border. The user can select this button by pressing the ENTER key. This style is useful for enabling the user to quickly select the most likely option. You can only have one Default button per dialog. It is recommended to make id& = 1, or id& = %IDOK for this control. Synonym of %BS_DEFPUSHBUTTON.


Create a flat button (without the raised 3D look).


Place the text against the left side of the button.


Wrap the caption text across multiple lines, if the text string is too long to fit on a single line in the button. To force a wrap, insert a $CR (or $CRLF) into the caption text at the desired wrap position.


Enable a button to send the %BN_KILLFOCUS and %BN_SETFOCUS notification messages to the button Callback Function.


The parent dialog Callback Function receives %WM_DRAWITEM messages when the control needs to be redrawn due to state changes or normal repainting.


The control is a push button control which sends %WM_COMMAND messages to the Callback Function of the parent dialog. (default)


Button state alternates (toggles) between normal (raised) and depressed (sunken) modes.


Place the text on the right side of the button.


Control displays a text caption/title. (default)


Place the text at the top edge of the button.


Center the text vertically in the button. (default)


Add a thin line border around the control.


Create a control that is initially disabled. A disabled control cannot receive input from the user. Use the CONTROL ENABLE statement to re-enable the button.


Define the start of a group of controls. The first control in each group should also use %WS_TABSTOP style. The next %WS_GROUP control in the tab order defines the end of this group and the start of a new group. Groups configured this way permit the arrow keys to shift focus between the controls within the group, and focus can jump from group to group with the usual TAB and SHIFT+TAB keys. Both tab stops and groups are permitted to wrap from the end of the tab order back to the start.


Allow button control to receive keyboard focus when the user presses the TAB and SHIFT+TAB keys. The TAB key shifts keyboard focus to the next control with the %WS_TABSTOP style, and SHIFT+TAB shifts focus to the previous control with %WS_TABSTOP. (default)


Extended Styles


The control will accept Drag+Drop files.


Apply a sunken edge border to the control.


The control has a double border.


The control has generic "left-aligned" properties. (default)


Display the caption text using Left to Right reading-order properties. (default)


The control has generic "right-aligned" properties. This style has an effect only if the shell language is Hebrew, Arabic, or another language that supports reading order alignment; otherwise, the style is ignored.


If the shell language is Hebrew, Arabic, or another language that supports reading order alignment, the caption text is displayed using Right to Left reading-order properties. For other languages, the style is ignored.


Apply a three-dimensional border style to the control (intended to be used for items that do not accept user input).


Controls/windows beneath the dialog are drawn before the dialog is drawn. The dialog is deemed transparent because elements behind the dialog have already been painted - the dialog itself is not drawn differently. True transparency is achieved by using Regions - see MSDN and/or the Platform SDK documentation for more information.


See Also

Styles reference