Programming |  Windows Programming |  BM_SETSTATE

BM_SETSTATE

Sets the highlight state of a button. The highlight state indicates whether the button is highlighted as if the user had pushed it.

Syntax

To send this message, call the SendMessage function as follows.

    lResult = SendMessage(       // returns LRESULT in lResult     
        (HWND) hWndControl,      // handle to destination control     
        (UINT) BM_SETSTATE,      // message ID     
        (WPARAM) wParam,         // = (WPARAM) () wParam;    
        (LPARAM) lParam          // = 0; not used, must be zero 
    );   

Parameters

• wParam
  Specifies whether the button is highlighted. A value of TRUE highlights the button. A value of FALSE removes any highlighting.
• lParam
  Not used.

Return Value

This message always returns zero.

Remarks

Highlighting affects only the appearance of a button. It has no effect on the check state of a radio button or check box.

A button is automatically highlighted when the user positions the cursor over it and presses and holds the left mouse button. The highlighting is removed when the user releases the mouse button.

Message Information

• Header Declared in Winuser.h, include Windows.h
• Minimum operating systems Windows 95, Windows NT 3.1

See also: Button_SetState