Mensagem WM_MOUSEACTIVATE

  • Artigo

Enviado quando o cursor está em uma janela inativa e o usuário clica em um botão do mouse. A janela pai receberá essa mensagem somente se a janela filho a passar para a função DefWindowProc.

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

#define WM_MOUSEACTIVATE                0x0021

Parâmetros

wParam

Um identificador para a janela pai de nível superior da janela que está sendo ativada.

lParam

A palavra de ordem inferior especifica o valor do teste de clique retornado pela função DefWindowProc em decorrência do processamento da mensagem WM_NCHITTEST. Para ver uma lista de valores do teste de clique, confira WM_NCHITTEST.

A palavra de ordem superior especifica o identificador da mensagem do mouse gerada quando o usuário pressiona um botão do mouse. A mensagem do mouse é descartada ou postada na janela, dependendo do valor retornado.

Valor retornado

O valor retornado especifica se a janela deve ser ativada e se o identificador da mensagem do mouse deve ser descartado. Deve ser um dos valores a seguir.

Valor/código retornado Descrição
MA_ACTIVATE
1
 Ativa a janela e não descarta a mensagem do mouse.
MA_ACTIVATEANDEAT
2
 Ativa a janela e descarta a mensagem do mouse.
MA_NOACTIVATE
3
 Não ativa a janela e não descarta a mensagem do mouse.
MA_NOACTIVATEANDEAT
4
 Não ativa a janela, mas descarta a mensagem do mouse.

Comentários

A função DefWindowProc passa a mensagem para a janela pai de uma janela filho antes que qualquer processamento ocorra. A janela pai determina se a janela filho deve ser ativada. Se ativar a janela filho, a janela pai deverá retornar MA_NOACTIVATE ou MA_NOACTIVATEANDEAT para impedir que o sistema processe ainda mais a mensagem.

Requisitos

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

Confira também

Referência

DefWindowProc

HIWORD

LOWORD

WM_NCHITTEST

Conceitual

Entrada por mouse