BM SETHILITE: Difference between revisions

Latest revision as of 04:36, 19 April 2025

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.

@@ Line 24: / Line 24: @@
 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.
+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==