Função DispatchMessage (winuser.h)
Envia uma mensagem para um procedimento de janela. Normalmente, ele é usado para expedir uma mensagem recuperada pela função GetMessage .
Sintaxe
LRESULT DispatchMessage(
[in] const MSG *lpMsg
);
Parâmetros
[in] lpMsg
Tipo: const MSG*
Um ponteiro para uma estrutura que contém a mensagem.
Retornar valor
Tipo: LRESULT
O valor retornado especifica o valor retornado pelo procedimento de janela. Embora seu significado dependa da mensagem que está sendo expedida, o valor retornado geralmente é ignorado.
Comentários
A estrutura MSG deve conter valores de mensagem válidos. Se o parâmetro lpmsg apontar para uma mensagem WM_TIMER e o parâmetro lParam da mensagem WM_TIMER não for NULL, lParam apontará para uma função que é chamada em vez do procedimento de janela.
Observe que o aplicativo é responsável por recuperar e expedir mensagens de entrada para a caixa de diálogo. A maioria dos aplicativos usa o loop de mensagem main para isso. No entanto, para permitir que o usuário se mova para e selecione controles usando o teclado, o aplicativo deve chamar IsDialogMessage. Para obter mais informações, consulte Interface do teclado da caixa de diálogo.
Exemplos
Para obter um exemplo, consulte Criando um loop de mensagem.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | winuser.h (inclua Windows.h) |
Biblioteca | User32.lib |
DLL | User32.dll |
Conjunto de APIs | ext-ms-win-ntuser-message-l1-1-0 (introduzido em Windows 8) |
Confira também
Conceitual
Mensagens e filas de mensagens
Referência