Mensagem OCM_PARENTNOTIFY

  • Artigo

Enviado para uma janela quando ocorre uma ação significativa em uma janela descendente. Essa mensagem agora é estendida para incluir o evento WM_POINTERDOWN. Quando a janela filho está sendo criada, o sistema envia WM_PARENTNOTIFY pouco antes da função CreateWindow ou CreateWindowEx que cria a janela retorna. Quando a janela filho está sendo destruída, o sistema envia a mensagem antes que qualquer processamento para destruir a janela ocorra.

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

![Importante]
Os aplicativos da área de trabalho devem estar cientes do DPI. Se seu aplicativo não estiver ciente do DPI, as coordenadas de tela contidas em mensagens de ponteiro e estruturas relacionadas poderão parecer imprecisas devido à virtualização de DPI. A virtualização de DPI fornece suporte de dimensionamento automático para aplicativos que não têm reconhecimento de DPI e estão ativos por padrão (os usuários podem desativá-lo). Para obter mais informações, confira Escrevendo aplicativos Win32 de Alto DPI.

#define WM_PARENTNOTIFY             0x0210

Parâmetros

wParam

A palavra de ordem baixa de wParam especifica o evento para o qual o pai está sendo notificado. O valor da palavra de ordem alta depende do valor da palavra de ordem baixa. Esse parâmetro pode usar um dos valores a seguir.

LOWORD(wParam) Significado
WM_CREATE
0x0001
 A janela filho está sendo criada.
HIWORD(wParam) é o identificador da janela filho.
lParam é um identificador para a janela filho.
WM_DESTROY
0x0002
 A janela filho está sendo criada.
HIWORD(wParam) é o identificador da janela filho.
lParam é um identificador para a janela filho.
WM_LBUTTONDOWN
0x0201
 O usuário colocou o cursor sobre a janela filho e clicou no botão esquerdo do mouse.
HIWORD(wParam) é indefinido.
lParam é a coordenada x do cursor é a palavra de ordem baixa e a coordenada y do cursor é a palavra de alta ordem.
WM_MBUTTONDOWN
0x0207
 O usuário colocou o cursor sobre a janela filho e clicou no botão do meio do mouse.
HIWORD(wParam) é indefinido.
lParam é a coordenada x do cursor é a palavra de ordem baixa e a coordenada y do cursor é a palavra de alta ordem.
WM_RBUTTONDOWN
0x0204
 O usuário colocou o cursor sobre a janela filho e clicou no botão direito do mouse.
HIWORD(wParam) é indefinido.
lParam é a coordenada x do cursor é a palavra de ordem baixa e a coordenada y do cursor é a palavra de alta ordem.
WM_XBUTTONDOWN
0x020B
 O usuário colocou o cursor sobre a janela filho e clicou no primeiro ou segundo botão X.
HIWORD(wParam) indica qual botão foi pressionado. Esse parâmetro pode usar um dos valores a seguir: XBUTTON1 or XBUTTON2.
lParam é a coordenada x do cursor é a palavra de ordem baixa e a coordenada y do cursor é a palavra de alta ordem.
WM_POINTERDOWN
0x0246
 Um ponteiro fez contato com a janela filho.
HIWORD(wParam) contém o identificador do ponteiro que gerou o evento WM_POINTERDOWN.

lParam

Contém a localização do ponto do ponteiro.

Observação

Como o ponteiro pode fazer contato com o dispositivo em uma área não trivial, essa localização do ponto pode ser uma simplificação de uma área mais complexa do ponteiro. Sempre que possível, um aplicativo deve usar as informações completas da área do ponteiro em vez da localização do ponto.

Utilize as seguintes macros para obter as coordenadas físicas da tela do ponto.

Valor retornado

Se o aplicativo processar essa mensagem, ele retorna zero.

Se o aplicativo não processar essa mensagem, ele chama DefWindowProc.

Comentários

Essa mensagem também é enviada para todas as janelas ancestrais da janela filho, incluindo a janela de nível superior.

Todas as janelas filho, exceto aquelas que têm o estilo de janela WS_EX_NOPARENTNOTIFY estendida, enviam essa mensagem para suas janelas pai. Por padrão, as janelas filho em uma caixa de diálogo têm o estilo WS_EX_NOPARENTNOTIFY, a menos que a função CreateWindowEx seja chamada para criar a janela filho sem esse estilo.

Essa notificação fornece às janelas ancestrais da janela filho uma oportunidade para examinar as informações do ponteiro e, se necessário, capturar o ponteiro usando as funções de captura de ponteiro.

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

Createwindow

Createwindowex

HIWORD

LOWORD

WM_CREATE

WM_DESTROY

WM_LBUTTONDOWN

WM_MBUTTONDOWN

WM_RBUTTONDOWN

WM_XBUTTONDOWN