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 |
|
See also
-
Reference
-
Conceptual