Função DispatchMessage (winuser.h)

Artigo
03/04/2024

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)