PeekMessage

9/9/2008

Essa função verifica um fila de mensagens segmento para uma mensagem e coloca a mensagem (se houver) na estrutura especificada.

Syntax

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

Parameters

• lpMsg
  [out] Ponteiro para um MSG estrutura que recebe informações mensagem.

• hWnd
  [no] Identificador para a janela cujas mensagens devem ser examinados.

• wMsgFilterMin
  [no] Especifica o valor da primeira mensagem no intervalo de mensagens a ser examinado.

• wMsgFilterMax
  [no] Especifica o valor da última mensagem o intervalo de mensagens a ser examinado.

• wRemoveMsg
  [no] Especifica como as mensagens são tratadas. Este parâmetro pode ser uma dos seguinte valores.

  Valor	Descrição
  PM_NOREMOVE	As mensagens não são removidas da fila após processamento pelo PeekMessage.
  PM_REMOVE	Mensagens são removidas a partir de fila após processamento pelo PeekMessage. Uma exceção é mensagens WM_PAINT, que não são removidas a partir de fila.

  Opcionalmente, você pode combinar o valor PM_NOYIELD com PM_NOREMOVE ou PM_REMOVE. Este sinalizador impede que o sistema liberando qualquer segmento que está aguardando o chamador para ir ocioso.

Return Value

Nonzero indica sucesso. Zero indica falha.

Remarks

Ao contrário de GetMessage função, o PeekMessage função não aguarda uma mensagem sejam colocados na fila antes de retornar.

PeekMessage Recupera somente 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, PeekMessage Recupera as mensagens para qualquer janela que pertence a atual segmento tornar a chamar. (PeekMessage Não recuperar mensagens para janelas que pertencem a outros segmentos.) Se hWnd é – 1, PeekMessage Somente retorna mensagens com um hWnd valor de NULL, como lançado pela PostThreadMessage função. Se wMsgFilterMin e wMsgFilterMax são os dois zero, PeekMessage 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 todos os teclado mensagens; As constantes WM_MOUSEFIRST e WM_MOUSELAST podem ser usadas para recuperar todas as mensagens mouse.

O PeekMessage função não não mensagens WM_PAINT remover a partir de fila. As mensagens WM_PAINT permanecem na fila até que eles são processados.

Chamando PeekMessage Antes de parte superior nível janela de um aplicativo é criada irá resultar na janela que está sendo criada de voltar de z-ordem. Você precisará explicitamente chamar SetForegroundWindow para a janela quando ela é criada após um chamar para apresentação PeekMessage. Se o aplicativo já tiver uma janela no primeiro plano, em seguida, a nova janela será criada no primeiro plano.

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
GetMessage
IsChild
PostThreadMessage
MSG