BM SETHILITE

This message sets the highlight state of a button control.

Syntax

param1
    USHORT ushilite;  /* Highlight indicator. */

param2
    ULONG  ulReserved; /* Reserved value, should be 0. */

Parameters

ushilite (USHORT) - input

Highlight indicator.

TRUE: Display the button control in the highlighted state.

FALSE: Display the button control in the unhighlighted state.

ulReserved (ULONG) - input

Reserved value, should be 0.

Returns

foldstate (BOOL) - returns

Old highlight state.

TRUE: The button control was in highlighted state.

FALSE: The button control was in unhighlighted state.

Remarks

The button control responds to this message, if it has a style of BS_PUSHBUTTON, BS_CHECKBOX, BS_AUTOCHECKBOX, BS_RADIOBUTTON, BS_AUTORADIOBUTTON, BS_3STATE, or BS_AUTO3STATE, by displaying the button control in the appropriate highlight state and setting foldstate as appropriate.

If the style of the Button Control is BS_USERBUTTON, a WM_CONTROL (in Button Controls) message is sent to its owner with usnotifycode set to BN_PAINT and with flcontrolspec pointing to a USERBUTTON structure and sets foldstate as appropriate.

Default Processing

The default window procedure does not expect to receive this message and therefore takes no action on it, other than to set foldstate to the default value of FALSE.