Programming |  Windows Programming |  Button_SetState

Button_SetState

Sets the highlight state of a button. The highlight state indicates whether the button is highlighted as if the user had pushed it. You can use this macro or send the BM_SETSTATE message explicitly.

Syntax

    LRESULT Button_SetState(
        HWND hwndCtl,
        BOOL state
    );

Parameters

• hwndCtl
  A handle to the button control.
• state
  TRUE to highlight the button; otherwise FALSE.

Return Value

The return value is always 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.

Macro Information

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

See also BM_SETSTATE