сообщение WM_POINTERCAPTURECHANGED

Статья
03/12/2025

Отправлено в окно, которое теряет запись входного указателя.

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

#define WM_POINTERCAPTURECHANGED           0x024C

Параметры

wParam

Содержит сведения о потерянной входной указателе. Используйте GET_POINTERID_WPARAM для получения идентификатора указателя.

lParam

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

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

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

Если приложение обрабатывает это сообщение, оно должно возвращать ноль.

Если приложение не обрабатывает это сообщение, он должен вызывать DefWindowProc.

Замечания

Окно должно использовать это уведомление, чтобы прекратить обработку последующих сообщений и инициировать любую очистку, необходимую для потери указателя. Обработка жестов, связанных с указателем, также должна быть прекращена (например, путем вызова StopInteractionContext) и оставшихся контактов, повторно связанных с окном.

Как правило, если окно получает уведомление WM_POINTERCAPTURECHANGED, последующие уведомления, связанные с указателем ввода, не будут получены. Из-за этого не зависят от парных уведомлений, таких как WM_POINTERENTER и WM_POINTERLEAVE.

WM_POINTERCAPTURECHANGED не включает данные POINTER_INFO. Кроме заданного флага POINTER_FLAG_CAPTURECHANGED, данные, возвращаемые GetPointerInfo (или любой вариант), идентичны возвращаемым до уведомления.

Если приложение не обрабатывает это уведомление, DefWindowProc может создать одно или несколько сообщений WM_GESTURE или, если жест не распознан, DefWindowProc может создать входные данные мыши.

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

Требования

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

См. также

сообщений

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