MiniGUI API Reference (MiniGUI-Threads)  v5.0.6
A mature and proven cross-platform GUI system for embedded and smart IoT devices
Macros
Styles of button control

Macros

#define BS_PUSHBUTTON   0x00000000L
 Creates a push button that is a pane that displays either a piece of text or an image and when it is pressed it performs an action. More...
 
#define BS_DEFPUSHBUTTON   0x00000001L
 Creates a push button that behaves like a BS_PUSHBUTTON style button. More...
 
#define BS_CHECKBOX   0x00000002L
 Creates a check button is a button that can be either selected or deselected, and its selection is independent of the selections of any other buttons. More...
 
#define BS_AUTOCHECKBOX   0x00000003L
 Creates a button that is almost the same as a check box. More...
 
#define BS_RADIOBUTTON   0x00000004L
 Creates a radio button that can be either selected or deselected, but when selecting it any other buttons in its group will be cleared. More...
 
#define BS_AUTORADIOBUTTON   0x00000005L
 Creates a button that is almost the same as a radio button. More...
 
#define BS_3STATE   0x00000006L
 Creates a button that is almost the same as a check box. More...
 
#define BS_AUTO3STATE   0x00000007L
 Creates a button that is almost the same as a three-state check box. More...
 
#define BS_OWNERDRAW   0x0000000AL
 Creates an owner-drawn button. More...
 
#define BS_TYPEMASK   0x0000000FL
 The type mask of style of button. More...
 
#define BS_TEXT   0x00000000L
 Specifies that the button displays text. More...
 
#define BS_LEFTTEXT   0x00000020L
 Places text on the left side. More...
 
#define BS_ICON   0x00000040L
 Specifies that the button displays an icon. More...
 
#define BS_BITMAP   0x00000080L
 Specifies that the button displays a bitmap. More...
 
#define BS_CONTENTMASK   0x000000F0L
 The content mask of style of button. More...
 
#define BS_LEFT   0x00000100L
 Left-justifies the text in the button rectangle. More...
 
#define BS_RIGHT   0x00000200L
 Right-justifies text in the button rectangle. More...
 
#define BS_CENTER   0x00000300L
 Centers text horizontally in the button rectangle. More...
 
#define BS_TOP   0x00000400L
 Places text at the top of the button rectangle. More...
 
#define BS_BOTTOM   0x00000800L
 Places text at the bottom of the button rectangle. More...
 
#define BS_VCENTER   0x00000C00L
 Places text in the middle (vertically) of the button rectangle. More...
 
#define BS_REALSIZEIMAGE   0x00000F00L
 Does not scale the image. More...
 
#define BS_ALIGNMASK   0x00000F00L
 The alignment mask of style of button. More...
 
#define BS_PUSHLIKE   0x00001000L
 Makes a button look and act like a push button. More...
 
#define BS_MULTLINE   0x00002000L
 Wraps the button text to multiple lines. More...
 
#define BS_NOTIFY   0x00004000L
 Enables a button to send notification messages to its parent window. More...
 
#define BS_CHECKED   0x00004000L
 Makes a button checked initially. More...
 
#define BS_FLAT   0x00008000L
 The flat style of button. More...
 
#define BS_NOBORDER   0x00010000L
 The no border style of button. More...
 
#define BS_RIGHTBUTTON   BS_LEFTTEXT
 The right style of button. More...
 

Detailed Description

Macro Definition Documentation

◆ BS_3STATE

#define BS_3STATE   0x00000006L

Creates a button that is almost the same as a check box.

Creates a button that is the same as a check box, except that the box can be grayed as well as checked or unchecked. Use the grayed state to show that the state of the check box is not determined.

Definition at line 174 of file button.h.

◆ BS_ALIGNMASK

#define BS_ALIGNMASK   0x00000F00L

The alignment mask of style of button.

Definition at line 291 of file button.h.

◆ BS_AUTO3STATE

#define BS_AUTO3STATE   0x00000007L

Creates a button that is almost the same as a three-state check box.

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

Definition at line 184 of file button.h.

◆ BS_AUTOCHECKBOX

#define BS_AUTOCHECKBOX   0x00000003L

Creates a button that is almost the same as a check box.

Creates a button that is the same as a check box, except that the check state automatically toggles between checked and unchecked each time the user selects the check box.

Definition at line 138 of file button.h.

◆ BS_AUTORADIOBUTTON

#define BS_AUTORADIOBUTTON   0x00000005L

Creates a button that is almost the same as a radio button.

Creates a button that is the same as a radio button, except that when the user selects it, The system automatically sets the button's check state to checked and automatically sets the check state for all other buttons in the same group to unchecked.

Definition at line 163 of file button.h.

◆ BS_BITMAP

#define BS_BITMAP   0x00000080L

Specifies that the button displays a bitmap.

Definition at line 230 of file button.h.

◆ BS_BOTTOM

#define BS_BOTTOM   0x00000800L

Places text at the bottom of the button rectangle.

Definition at line 273 of file button.h.

◆ BS_CENTER

#define BS_CENTER   0x00000300L

Centers text horizontally in the button rectangle.

Definition at line 261 of file button.h.

◆ BS_CHECKBOX

#define BS_CHECKBOX   0x00000002L

Creates a check button is a button that can be either selected or deselected, and its selection is independent of the selections of any other buttons.

By default, the text is displayed to the right of the check box. To display the text to the left of the check box, combine this flag with the BS_LEFTTEXT style (or with the equivalent BS_RIGHTBUTTON style).

Definition at line 128 of file button.h.

◆ BS_CHECKED

#define BS_CHECKED   0x00004000L

Makes a button checked initially.

Definition at line 322 of file button.h.

◆ BS_CONTENTMASK

#define BS_CONTENTMASK   0x000000F0L

The content mask of style of button.

Definition at line 235 of file button.h.

◆ BS_DEFPUSHBUTTON

#define BS_DEFPUSHBUTTON   0x00000001L

Creates a push button that behaves like a BS_PUSHBUTTON style button.

Creates a push button that behaves like a BS_PUSHBUTTON style button, but also has a heavy black border. If the button is in a dialog box, the user can select the button by pressing the enter key, even when the button does not have the input focus. This style is useful for enabling the user to quickly select the most likely (default) option.

Definition at line 116 of file button.h.

◆ BS_FLAT

#define BS_FLAT   0x00008000L

The flat style of button.

Definition at line 328 of file button.h.

◆ BS_ICON

#define BS_ICON   0x00000040L

Specifies that the button displays an icon.

Definition at line 224 of file button.h.

◆ BS_LEFT

#define BS_LEFT   0x00000100L

Left-justifies the text in the button rectangle.

However, if the button is a check box or radio button that does not have the BS_RIGHTBUTTON style, the text is left justified on the right side of the check box or radio button.

Definition at line 245 of file button.h.

◆ BS_LEFTTEXT

#define BS_LEFTTEXT   0x00000020L

Places text on the left side.

Places text on the left side of the radio button or check box when combined with a radio button or check box style.

Definition at line 218 of file button.h.

◆ BS_MULTLINE

#define BS_MULTLINE   0x00002000L

Wraps the button text to multiple lines.

Wraps the button text to multiple lines if the text string is too long to fit on a single line in the button rectangle.

Definition at line 310 of file button.h.

◆ BS_NOBORDER

#define BS_NOBORDER   0x00010000L

The no border style of button.

Definition at line 334 of file button.h.

◆ BS_NOTIFY

#define BS_NOTIFY   0x00004000L

Enables a button to send notification messages to its parent window.

Definition at line 316 of file button.h.

◆ BS_OWNERDRAW

#define BS_OWNERDRAW   0x0000000AL

Creates an owner-drawn button.

Note
Not implemented so far.

Definition at line 197 of file button.h.

◆ BS_PUSHBUTTON

#define BS_PUSHBUTTON   0x00000000L

Creates a push button that is a pane that displays either a piece of text or an image and when it is pressed it performs an action.

Definition at line 103 of file button.h.

◆ BS_PUSHLIKE

#define BS_PUSHLIKE   0x00001000L

Makes a button look and act like a push button.

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 isn't pushed or checked, and sunken when it is pushed or checked.

Definition at line 301 of file button.h.

◆ BS_RADIOBUTTON

#define BS_RADIOBUTTON   0x00000004L

Creates a radio button that can be either selected or deselected, but when selecting it any other buttons in its group will be cleared.

By default, the text is displayed to the right of the circle. To display the text to the left of the circle, combine this flag with the BS_LEFTTEXT style (or with the equivalent BS_RIGHTBUTTON style). Use radio buttons for groups of related, but mutually exclusive choices.

Definition at line 151 of file button.h.

◆ BS_REALSIZEIMAGE

#define BS_REALSIZEIMAGE   0x00000F00L

Does not scale the image.

Definition at line 285 of file button.h.

◆ BS_RIGHT

#define BS_RIGHT   0x00000200L

Right-justifies text in the button rectangle.

However, if the button is a check box or radio button that does not have the BS_RIGHTBUTTON style, the text is right justified on the right side of the check box or radio button.

Definition at line 255 of file button.h.

◆ BS_RIGHTBUTTON

#define BS_RIGHTBUTTON   BS_LEFTTEXT

The right style of button.

See also
BS_LEFTTEXT

Definition at line 341 of file button.h.

◆ BS_TEXT

#define BS_TEXT   0x00000000L

Specifies that the button displays text.

Definition at line 209 of file button.h.

◆ BS_TOP

#define BS_TOP   0x00000400L

Places text at the top of the button rectangle.

Definition at line 267 of file button.h.

◆ BS_TYPEMASK

#define BS_TYPEMASK   0x0000000FL

The type mask of style of button.

Definition at line 203 of file button.h.

◆ BS_VCENTER

#define BS_VCENTER   0x00000C00L

Places text in the middle (vertically) of the button rectangle.

Definition at line 279 of file button.h.