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.

Value Meaning
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.

Value Meaning
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

Requirement Value
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