Messages of button control
[Button control]

Defines

• #define BM_GETCHECK   0xF0F0

  Retrieves the check state of a radio button or check box.
  

• #define BM_SETCHECK   0xF0F1

  Sets the check state of a radio button or check box.
  

• #define BM_GETSTATE   0xF0F2

  Gets the state of a button or check box.
  

• #define BM_SETSTATE   0xF0F3

  Sets the state of a button.
  

• #define BM_SETSTYLE   0xF0F4

  Changes the style of a button.
  

• #define BM_CLICK   0xF0F5

  Simulates the user clicking a button.
  

• #define BM_ENABLE   0xF0F6

  enable or disable the button. If it is disabled, it can receive mouse and key messages but don't response them
  

• #define BM_GETIMAGE   0xF0F7

  Retrieves the handle to the image.
  

• #define BM_SETIMAGE   0xF0F8

  Associates a new image (icon or bitmap) with the button.
  

---

Define Documentation

#define BM_CLICK   0xF0F5

Simulates the user clicking a button.

An application sends a BM_CLICK message to simulate the user clicking a button.

 BM_CLICK

 wParam = 0;
 lParam = 0;

Definition at line 516 of file button.h.

#define BM_ENABLE   0xF0F6

enable or disable the button. If it is disabled, it can receive mouse and key messages but don't response them

 BM_CLICK

 wParam = (BOOL)enable;
 lParam = 0;

Parameters:

enable

TRUE--enable the button FALSE--disable the button.

Returns:

Always be zero.

Definition at line 535 of file button.h.

#define BM_GETCHECK   0xF0F0

Retrieves the check state of a radio button or check box.

An application sends a BM_GETCHECK message to retrieve the check state of a radio button or check box.

 BM_GETCHECK
 wParam = 0;
 lParam = 0;

Returns:

An integer indicates whether the button is checked.

Return values:

	BST_UNCHECKED	The button is not checked.
	BST_CHECKED	The button is checked.
	BST_INDETERMINATE	The button is grayed because the state of the button is indeterminate.

See also:

States of button control

Definition at line 409 of file button.h.

#define BM_GETIMAGE   0xF0F7

Retrieves the handle to the image.

An application sends a BM_GETIMAGE message to retrieve a handle to the image (icon or bitmap) associated with the button.

 BM_GETIMAGE
 int image_type;

 wParam = (WPARAM)&image_type;
 lParam = 0;

Parameters:

image_type

The type of a button image will be returned through this buferr. It can be one of the following values: BM_IMAGE_BITMAP Bitmap of a button. BM_IMAGE_ICON Icon of a button.

Returns:

A handle of the bitmap or icon of the button, zero when error.

Definition at line 561 of file button.h.

#define BM_GETSTATE   0xF0F2

Gets the state of a button or check box.

An application sends a BM_GETSTATE message to determine the state of a button or check box.

 BM_GETSTATE
 wParam = 0;
 lParam = 0;

Returns:

An integer indicates the button state.

See also:

States of button control

Definition at line 454 of file button.h.

#define BM_SETCHECK   0xF0F1

Sets the check state of a radio button or check box.

An application sends a BM_SETCHECK message to set the check state of a radio button or check box.

 BM_SETCHECK
 int check_state;

 wParam = (WPARAM)check_state;
 lParam = 0;

Parameters:

check_state

The check state of button, can be one of the following values: BST_UNCHECKED Want the button to be unchecked. BST_CHECKED Want the button to be checked. BST_INDETERMINATE Want the button to be grayed if it is a three states button.

Returns:

The old button state.

Definition at line 435 of file button.h.

#define BM_SETIMAGE   0xF0F8

Associates a new image (icon or bitmap) with the button.

An application sends a BM_SETIMAGE message to associate a new image (icon or bitmap) with the button.

Please use BM_IMAGE_BITMAP or BM_IMAGE_ICON as the first parameter of the message to indicate the type of button control image:

• BM_IMAGE_BITMAP
  Specifies the type of image to associate with the button to be a bitmap.
• BM_IMAGE_ICON
  Specifies the type of image to associate with the button to be an icon.

Definition at line 580 of file button.h.

#define BM_SETSTATE   0xF0F3

Sets the state of a button.

An application sends a BM_SETSTATE message to set the state of a button.

 BM_SETSTATE
 int push_state;

 wParam = (WPARAM)push_state;
 lParam = 0;

Parameters:

push_state

The push state of a button, can be one of the following values: Zero Want the button to be unpushed. Non zero Want the button to be pushed.

Returns:

The old button state.

Definition at line 479 of file button.h.

#define BM_SETSTYLE   0xF0F4

Changes the style of a button.

An application sends a BM_SETSTYLE message to change the style of a button.

 BM_SETSTYLE
 int button_style;

 wParam = (WPARAM)button_style;
 lParam = 0;

Parameters:

button_style

The styles of a button.

Returns:

Always be zero.

See also:

Styles of button control

Definition at line 501 of file button.h.