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

See Also

Reference

Message Queue Functions
IsChild
PeekMessage
PostMessage
PostThreadMessage
WM_PAINT
WM_QUIT
MSG