WM_UPDATEUISTATE message

An application sends the WM_UPDATEUISTATE message to change the UI state for the specified window and all its child windows.


#define WM_UPDATEUISTATE                0x0128

Parameters

wParam

The low-order word specifies the action to be performed. This parameter can be one of the following values.

ValueMeaning
UIS_CLEAR
2

The UI state element specified by the high-order word should be hidden.

UIS_INITIALIZE
3

The UI state element specified by the high-order word should be changed based on the last input event. For more information, see Remarks.

UIS_SET
1

The UI state element specified by the high-order word should be visible.

 

The high-order word specifies which UI state elements are affected or the style of the control. This parameter can be one or more of the following values.

ValueMeaning
UISF_ACTIVE
0x4

A control should be drawn in the style used for active controls.

UISF_HIDEACCEL
0x2

Keyboard accelerators.

UISF_HIDEFOCUS
0x1

Focus indicators.

 

lParam

This parameter is not used.

Remarks

A window should send this message to change the UI state of all its child windows. In contrast to the WM_CHANGEUISTATE message, which is a notification, when DefWindowProc processes the WM_UPDATEUISTATE message it changes the UI state and propagates the changes to all child windows.

The DefWindowProc function updates the UI state according to the wParam value. If the UI state is modified, the function sends the message to all the immediate child windows. DefWindowProc also sends this message when it receives a WM_CHANGEUISTATE message notifying the system that a child window intends to modify the UI state.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

See also

Reference
DefWindowProc
WM_CHANGEUISTATE
WM_QUERYUISTATE
Conceptual
Keyboard Accelerators

 

 

Community Additions

ADD
Show:
© 2014 Microsoft