Compartilhar via


Mensagem WM_CHANGEUISTATE

Um aplicativo envia a mensagem WM_CHANGEUISTATE para indicar que o estado da interface do usuário deve ser alterado.

#define WM_CHANGEUISTATE                0x0127

Parâmetros

wParam

A palavra de ordem baixa especifica a ação a ser tomada. Esse membro pode ser um dos seguintes valores.

Valor Significado
UIS_CLEAR
2
Os sinalizadores de estado da interface do usuário especificados pela palavra de ordem alta devem ser limpos.
UIS_INITIALIZE
3
Os sinalizadores de estado da interface do usuário especificados pela palavra de ordem alta devem ser alterados com base no último evento de entrada. Para obter mais informações, consulte Comentários.
UIS_SET
1
Os sinalizadores de estado da interface do usuário especificados pela palavra de ordem alta devem ser definidos.

A palavra de ordem alta especifica quais elementos de estado da interface do usuário são afetados ou o estilo do controle. Esse membro pode ser um ou mais dos valores a seguir:

Valor Significado
UISF_ACTIVE
0x4
Um controle deve ser desenhado no estilo utilizado para controles ativos.
UISF_HIDEACCEL
0x2
Os aceleradores de teclado estão ocultos.
UISF_HIDEFOCUS
0x1
Os indicadores de foco estão ocultos.

lParam

Esse parâmetro não é utilizado e deve ser 0.

Comentários

Uma janela deve enviar essa mensagem para si mesma ou para seu pai quando precisar alterar os elementos de estado da interface do usuário de todas as janelas na mesma hierarquia. O procedimento de janela deve permitir que DefWindowProc processe essa mensagem para que toda a árvore de janelas tenha um estado de interface do usuário consistente. Quando a janela principal recebe a mensagem WM_CHANGEUISTATE, ela envia uma mensagem WM_UPDATEUISTATE com os mesmos parâmetros para todas as janelas secundárias. Quando o sistema processa a mensagem WM_UPDATEUISTATE, ele faz a alteração no estado da interface do usuário.

Se a palavra de ordem baixa de wParam for UIS_INITIALIZE, o sistema enviará a mensagem WM_UPDATEUISTATE com um estado de interface do usuário baseado no último evento de entrada. Por exemplo, se a última entrada tiver sido feita pelo mouse, o sistema ocultará as dicas do teclado. E, se a última entrada tiver sido feita pelo teclado, o sistema mostrará as dicas do teclado. Se o estado resultante do processamento de WM_CHANGEUISTATE for o mesmo que o estado antigo, DefWindowProc não enviará essa mensagem.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos para desktop]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclui Windows.h)

Confira também

Referência

HIWORD

LOWORD

WM_QUERYUISTATE

Conceitual

Aceleradores de teclado