WM_NCXBUTTONDOWN mensagem
Postado quando o usuário pressiona XBUTTON1 ou XBUTTON2 enquanto o cursor está na área não cliente de uma janela. Esta mensagem é publicada na janela que contém o cursor. Se uma janela capturou o rato, esta mensagem não publicada.
Uma janela recebe esta mensagem através da sua função WindowProc.
#define WM_NCXBUTTONDOWN 0x00AB
Parâmetros
-
wParam
-
A palavra de ordem baixa especifica o valor hit-test retornado pelo função DefWindowProc do processamento da mensagem WM_NCHITTEST. Para obter uma lista de valores de teste de acerto, consulte WM_NCHITTEST. A palavra de ordem alta indica qual botão foi pressionado. Pode ser um dos seguintes valores.
Valor Significado - XBUTTON1
- 0x0001
A XBUTTON1 foi pressionada. - XBUTTON2
- 0x0002
A XBUTTON2 foi pressionada. -
lParam
-
Um ponteiro para um PONTOS estrutura que contém as coordenadas x e y do cursor. As coordenadas são relativas ao canto superior esquerdo da tela.
Valor de retorno
Se um aplicativo processar essa mensagem, ele deverá retornar TRUE. Para obter mais informações sobre como processar o valor de retorno, consulte a seção Comentários.
Comentários
O Windows suporta ratos com até cinco botões: esquerdo, médio e direito, além de dois botões adicionais chamados XBUTTON1 e XBUTTON2. Os botões XBUTTON1 e XBUTTON2 geralmente estão localizados nas laterais do mouse, perto da base. Esses botões extras não estão presentes em todos os mouses. Se estiverem presentes, os botões XBUTTON1 e XBUTTON2 geralmente são mapeados para uma função do aplicativo, como navegação para frente e para trás em um navegador da Web.
Use o código a seguir para obter as informações no parâmetro wParam.
nHittest = GET_NCHITTEST_WPARAM(wParam);
fwButton = GET_XBUTTON_WPARAM(wParam);
Você também pode usar o seguinte código para obter as coordenadas x e y de lParam:
xPos = GET_X_LPARAM(lParam);
yPos = GET_Y_LPARAM(lParam);
Importante
Não use o LOWORD ou macros 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 tratar as coordenadas como quantidades não assinadas.
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_NCMBUTTONDOWNe WM_NCRBUTTONDOWN, um aplicativo deve retornar TRUE dessa mensagem se a processar. Isso permitirá que o software que simula essa mensagem em sistemas Windows anteriores ao Windows 2000 determine se o procedimento de janela processou a mensagem ou chamou DefWindowProc para processá-la.
Requerimentos
| Exigência | Valor |
|---|---|
| Cliente mínimo suportado |
Windows 2000 Professional [apenas aplicações de ambiente de trabalho] |
| Servidor mínimo suportado |
Windows 2000 Server [apenas aplicações de ambiente de trabalho] |
| Cabeçalho |
|
Ver também
-
de referência
-
Conceptual
-
Outros recursos