GetMessage

9/9/2008

Essa função recupera uma mensagem a partir fila de mensagens do segmento de chamado e o coloca na estrutura especificada.

Syntax

BOOL GetMessage(
  LPMSG lpMsg, 
  HWND hWnd, 
  UINT wMsgFilterMin, 
  UINT wMsgFilterMax 
      );

Parameters

• lpMsg
  [out] Ponteiro para um MSG estrutura que recebe informações mensagem a partir fila de mensagens do segmento de.

• hWnd
  [no] Identificador para a janela cujas mensagens devem ser recuperadas. Um valor tem um significado especial.

  Valor	Descrição
  NULL	GetMessage Recupera mensagens para qualquer janela que pertence o segmento chamado segmento postados para o segmento chamado by means of e PostThreadMessage.

• wMsgFilterMin
  [no] Especifica o valor inteiro do menor valor mensagem a ser recuperados.

• wMsgFilterMax
  [no] Especifica a valor inteiro do valor mais alto mensagem a ser recuperados.

Return Value

Nonzero indica que a função recupera uma mensagem diferente WM_QUIT. Zero indica que a função recupera a mensagem WM_QUIT, ou que lpMsg é um inválido ponteiro. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Usa um geralmente aplicativo o valor de retorno para determinar se deve finalizar a mensagem principal executar um loop e sair de programa.

O GetMessage função somente recupera mensagens associado com a janela identificada pelo hWnd parâmetro ou qualquer um dos seus filhos, conforme especificado pelo IsChild função e o intervalo de valores mensagem fornecidos pelo wMsgFilterMin e wMsgFilterMax Parâmetros. Se hWnd é NULL, GetMessage Recupera mensagens para qualquer janela que pertence o segmento chamado segmento postados para o segmento chamado by means of e PostThreadMessage. GetMessage Não recuperar mensagens para janelas que pertencem a outros segmentos nem de segmentos que não seja o segmento chamado, mesmo se hWnd não é NULL. Segmento mensagens, lançadas pela PostThreadMessage função, têm uma mensagem hWnd valor de NULL. Se wMsgFilterMin e wMsgFilterMax são os dois zero, GetMessage Retorna disponível todas as mensagens (ou seja, nenhum intervalo filtragem é executada).

As constantes WM_KEYFIRST e WM_KEYLAST podem ser usadas como valores filtro para recuperar todas as mensagens relacionado a entrada do teclado; As constantes WM_MOUSEFIRST e WM_MOUSELAST podem ser usadas para recuperar todas as mensagens mouse. Se a pasta wMsgFilterMin e wMsgFilterMax Os parâmetros são os dois zero, o GetMessage função retorna disponível todas as mensagens (que é, sem executar qualquer filtragem).

GetMessage remover não WM_PAINT mensagens a partir de fila. As mensagens permanecem na fila até que processados.

Requirements

Header	winuser.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Message Queue Functions
IsChild
PeekMessage
PostMessage
PostThreadMessage
WM_PAINT
WM_QUIT
MSG