Compartilhar via


Mensagem WM_POINTERACTIVATE

Enviado para uma janela inativa quando um ponteiro primário gera um WM_POINTERDOWN pela janela. Enquanto a mensagem permanecer sem manipulação, ela percorrerá a cadeia da janela pai até chegar à janela de nível superior. Os aplicativos podem responder a essa mensagem para especificar se desejam ser ativados.

Uma janela recebe essa mensagem por meio da sua função WindowProc.

#define WM_POINTERACTIVATE             0x024B

Parâmetros

wParam

Contém o identificador do ponteiro e informações adicionais. Use as macros a seguir para obter essas informações.

GET_POINTERID_WPARAM(wParam): identificador de ponteiro

HIWORD(wParam): valor do teste de ocorrência retornado do processamento da mensagem WM_NCHITTEST.

lParam

Contém o identificador para a janela de nível superior da janela que está sendo ativada.

Valor retornado

Se um aplicativo processar essa mensagem, ele deverá retornar um dos valores descritos na seção Comentários.

Se o aplicativo não processar essa mensagem, ele deverá chamar DefWindowProc.

Comentários

Um aplicativo pode manipular essa mensagem e retornar um dos seguintes valores para determinar como o sistema processa a ativação e a entrada de ativação:

  • PA_ACTIVATE
  • PA_NOACTIVATE

É importante observar que, quando o usuário está interagindo com o sistema com vários ponteiros simultâneos, a oportunidade de ativação que a mensagem WM_POINTERACTIVATE representa está disponível para os aplicativos apenas para o primeiro desses ponteiros. Os aplicativos devem, portanto, estar cientes de que ainda podem receber informações de ponteiros enquanto estiverem inativos.

Se o aplicativo não manipular essa mensagem, DefWindowProc passa a mensagem para a janela pai.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclui Windows.h)

Confira também

Mensagens