Поделиться через


сообщение WM_XBUTTONDBLCLK

Опубликовано, когда пользователь дважды щелкает XBUTTON1 или XBUTTON2, пока курсор находится в клиентской области окна. Если мышь не захвачена, сообщение будет размещено в окне под курсором. В противном случае сообщение публикуется в окне, которое захватило мышь.

Окно получает это сообщение через функцию WindowProc.

#define WM_XBUTTONDBLCLK                0x020D

Параметры

wParam

Слово с низким порядком указывает, отключены ли различные виртуальные ключи. Это может быть одно или несколько следующих значений.

Ценность Значение
MK_CONTROL
0x0008
Клавиша CTRL вниз.
MK_LBUTTON
0x0001
Левая кнопка мыши вниз.
MK_MBUTTON
0x0010
Средняя кнопка мыши вниз.
MK_RBUTTON
0x0002
Правая кнопка мыши вниз.
MK_SHIFT
0x0004
Клавиша SHIFT вниз.
MK_XBUTTON1
0x0020
XBUTTON1 вниз.
MK_XBUTTON2
0x0040
XBUTTON2 вниз.

Слово с высоким порядком указывает, какая кнопка была дважды щелкаема. Это может быть одно из следующих значений.

Ценность Значение
XBUTTON1
0x0001
XBUTTON1 дважды щелкнул.
XBUTTON2
0x0002
XBUTTON2 дважды щелкните.

lParam

Слово с низким порядком указывает координату x курсора. Координата относительно левого верхнего угла клиентской области.

Слово с высоким порядком задает координату курсора y. Координата относительно левого верхнего угла клиентской области.

Возвращаемое значение

Если приложение обрабатывает это сообщение, оно должно возвращать TRUE. Дополнительные сведения об обработке возвращаемого значения см. в разделе "Примечания".

Замечания

Windows поддерживает мыши с пятью кнопками: слева, серединой и справа, а также двумя дополнительными кнопками, называемыми XBUTTON1 и XBUTTON2. Кнопки XBUTTON1 и XBUTTON2 часто расположены на стороне мыши рядом с базой. Эти дополнительные кнопки не присутствуют на всех мышах. При наличии кнопки XBUTTON1 и XBUTTON2 часто сопоставляются с функцией приложения, например переадресации вперед и назад в веб-браузере.

Используйте следующий код, чтобы получить сведения в параметре wParam:

fwKeys = GET_KEYSTATE_WPARAM (wParam); 
fwButton = GET_XBUTTON_WPARAM (wParam); 

Используйте следующий код для получения горизонтальной и вертикальной позиции:

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

Как отмечалось выше, координата x находится в низком порядке коротких возвращаемого значения; Координата y находится в коротких (оба представляют подписанные значения, так как они могут принимать отрицательные значения в системах с несколькими мониторами). Если возвращаемое значение назначено переменной, можно использовать макрос MAKEPOINTS для получения структуры ТОЧЕК из возвращаемого значения. Вы также можете использовать макрос GET_X_LPARAM или GET_Y_LPARAM для извлечения координат x-или y.

Важный

Не используйте loWORD или макросы HIWORD для извлечения координат курсора x-и y, так как эти макросы возвращают неверные результаты в системах с несколькими мониторами. Системы с несколькими мониторами могут иметь отрицательные координаты x и y, а LOWORD и HIWORD рассматривать координаты как неподписанные количества.

Только окна с стилем CS_DBLCLKS могут получать WM_XBUTTONDBLCLK сообщения, которые система создает всякий раз, когда пользователь нажимает, освобождает и снова нажимает XBUTTON1 или XBUTTON2 в пределах ограничения времени двойного щелчка мыши системы. Дважды щелкнув одну из этих кнопок, на самом деле создает четыре сообщения: WM_XBUTTONDOWN, WM_XBUTTONUP, WM_XBUTTONDBLCLKи WM_XBUTTONUP снова.

В отличие от WM_LBUTTONDBLCLK, WM_MBUTTONDBLCLKи WM_RBUTTONDBLCLK сообщений приложение должно возвращать TRUE из этого сообщения, если он обрабатывает его. Это позволит программному обеспечению, которое имитирует это сообщение в системах Windows до Windows 2000, чтобы определить, обработана ли процедура окна сообщение или вызвана DefWindowProc для его обработки.

Требования

Требование Ценность
Минимальный поддерживаемый клиент
Windows 2000 Профессиональный [только классические приложения]
Минимальный поддерживаемый сервер
Windows 2000 Server [только классические приложения]
Заголовок
Winuser.h (включая Windowsx.h)

См. также

Справочник

DefWindowProc

GET_KEYSTATE_WPARAM

GET_X_LPARAM

GET_XBUTTON_WPARAM

GET_Y_LPARAM

GetCapture

GetDoubleClickTime

SetDoubleClickTime

WM_XBUTTONDOWN

WM_XBUTTONUP

концептуальные

ввод мыши

другие ресурсы

MAKEPOINTS

ТОЧКИ