Compartilhar via


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

GetMessage

Isdialogmessage

MSG

Mensagens e filas de mensagens

PeekMessage

Referência

TranslateMessage

WM_TIMER