Mensagem WM_NCXBUTTONDOWN

Postado quando o usuário pressiona o primeiro ou o segundo botão X enquanto o cursor está na área que não é do cliente de uma janela. Esta mensagem é postada na janela que contém o cursor. Se uma janela tiver capturado o mouse, essa mensagem não será postada.

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

#define WM_NCXBUTTONDOWN                0x00AB

Parâmetros

wParam

A palavra de ordem inferior especifica o valor do teste de clique retornado pela função DefWindowProc do processamento da mensagem WM_NCHITTEST. Para ver uma lista de valores do teste de clique, confira WM_NCHITTEST. A palavra de ordem superior indica o botão que foi pressionado. Pode ser um dos seguintes valores.

Valor Significado
XBUTTON1
0x0001
O primeiro botão X foi pressionado.
XBUTTON2
0x0002
O segundo botão X foi pressionado.

lParam

Um ponteiro para uma estrutura POINTS que contém as coordenadas x e y do cursor. As coordenadas são relativas ao canto superior esquerdo da tela.

Valor retornado

Se o aplicativo processar essa mensagem, ela deverá retornar TRUE. Para saber mais sobre como processar o valor retornado, confira a seção Comentários.

Comentários

Use o código a seguir para obter as informações contidas no parâmetro wParam.

nHittest = GET_NCHITTEST_WPARAM(wParam); 
fwButton = GET_XBUTTON_WPARAM(wParam); 

Use também o seguinte código para obter as coordenadas x e y do lParam:

xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam); 

Importante

Não use as macros LOWORD ou HIWORD para extrair as coordenadas x e y da posição do cursor, porque essas macros retornam resultados incorretos em sistemas com vários monitores. Sistemas com vários monitores podem ter coordenadas x e y negativas, e LOWORD e HIWORD tratam as coordenadas como quantidades sem sinal.

Por padrão, a função DefWindowProc testa o ponto especificado para obter a posição do cursor e executa a ação apropriada. Se apropriado, ele envia a mensagem WM_SYSCOMMAND para a janela.

Ao contrário das mensagens WM_NCLBUTTONDOWN, WM_NCMBUTTONDOWN e WM_NCRBUTTONDOWN, um aplicativo retornará TRUE dessa mensagem se ele a processar. Isso permitirá que o software que simula essa mensagem em sistemas Windows anteriores ao Windows 2000 determine se o procedimento da janela processou a mensagem ou chamou DefWindowProc para processá-la.

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 Windowsx.h)

Confira também

Referência

DefWindowProc

GET_X_LPARAM

GET_Y_LPARAM

WM_NCHITTEST

WM_NCXBUTTONDBLCLK

WM_NCXBUTTONUP

WM_SYSCOMMAND

Conceitual

Entrada por mouse

Outros recursos

MAKEPOINTS

POINTS