WM_LBUTTONDBLCLK mensagem

Artigo
01/23/2025

Postado quando o usuário clica duas vezes no botão esquerdo do mouse enquanto o cursor está na área do cliente de uma janela. Se o mouse não for capturado, a mensagem será postada na janela abaixo do cursor. Caso contrário, a mensagem será postada na janela que capturou o mouse.

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

#define WM_LBUTTONDBLCLK                0x0203

Parâmetros

wParam

Indica se várias chaves virtuais estão inoperantes. Esse parâmetro pode ser um ou mais dos valores a seguir.

Valor	Significado
MK_CONTROL 0x0008	A tecla CTRL está inoperante.
MK_LBUTTON 0x0001	O botão esquerdo do mouse está inoperante.
MK_MBUTTON 0x0010	O botão do mouse do meio está inoperante.
MK_RBUTTON 0x0002	O botão direito do mouse está desligado.
MK_SHIFT 0x0004	A tecla SHIFT está inoperante.
MK_XBUTTON1 0x0020	O XBUTTON1 está inoperante.
MK_XBUTTON2 0x0040	O XBUTTON2 está inoperante.

lParam

A palavra de baixa ordem especifica a coordenada x do cursor. A coordenada é relativa ao canto superior esquerdo da área do cliente.

A palavra de alta ordem especifica a coordenada y do cursor. A coordenada é relativa ao canto superior esquerdo da área do cliente.

Valor de retorno

Se um aplicativo processar essa mensagem, ela deverá retornar zero.

Observações

Use o seguinte código para obter a posição horizontal e vertical:

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

Conforme observado acima, a coordenada x está na ordem inferior curto do valor retornado; a coordenada y está na curta (ambas representam valores assinados porque podem levar valores negativos em sistemas com vários monitores). Se o valor retornado for atribuído a uma variável, você poderá usar a macro MAKEPOINTS para obter uma estrutura POINTS do valor retornado. Você também pode usar a macro GET_X_LPARAM ou GET_Y_LPARAM para extrair a coordenada x ou y.

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 tratar as coordenadas como quantidades não assinadas.

Somente as janelas que têm o estilo CS_DBLCLKS podem receber mensagens WM_LBUTTONDBLCLK, que o sistema gera sempre que o usuário pressiona, libera e pressiona novamente o botão esquerdo do mouse dentro do limite de tempo de clique duplo do sistema. Clicar duas vezes no botão esquerdo do mouse gera uma sequência de quatro mensagens: WM_LBUTTONDOWN, WM_LBUTTONUP, WM_LBUTTONDBLCLKe WM_LBUTTONUP.

Requisitos

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

Consulte também

de referência de
GET_X_LPARAM
GET_Y_LPARAM
GetCapture
GetDoubleClickTime
SetCapture
SetDoubleClickTime
WM_LBUTTONDOWN
WM_LBUTTONUP
Conceitual
de entrada do mouse
outros recursos
MAKEPOINTS
POINTS

Compartilhar via