Сообщения

Разделы этого раздела содержат справочные спецификации для конкретных сообщений и уведомлений ввода указателя.

В этом разделе

Раздел Описание
DM_POINTERHITTEST
Отправляется в окно при первом обнаружении входных данных указателя, чтобы определить наиболее вероятный целевой объект ввода для прямой манипуляции.
WM_NCPOINTERDOWN
Публикуется, когда указатель устанавливает контакт над неклиентской областью окна. Сообщение нацелено на окно, через которое указатель устанавливает контакт. Указатель неявно захватывается в окно, чтобы окно продолжало получать входные данные для указателя, пока он не разорвет контакт.
Если окно захватило этот указатель, это сообщение не публикуется. Вместо этого WM_POINTERDOWN публикуется в окне, которое захватило этот указатель.
Внимание!
Классические приложения должны учитывать DPI. Если приложение не учитывает DPI, координаты экрана, содержащиеся в сообщениях указателя и связанных структурах, могут показаться неточными из-за виртуализации DPI. Виртуализация DPI обеспечивает поддержку автоматического масштабирования для приложений, которые не поддерживают DPI и активны по умолчанию (пользователи могут отключить его). Дополнительные сведения см. в статье Написание приложений Win32 с высоким разрешением.
WM_NCPOINTERUP
Публикуется, когда указатель, который сделал контакт над неклиентской областью окна, разрывает контакт. Сообщение нацелено на окно, через которое указатель устанавливает контакт, и в этот момент указатель неявно записывается в окно, чтобы окно продолжало получать входные данные для указателя до тех пор, пока он не разорвет контакт, включая уведомление WM_NCPOINTERUP .
Если окно захватило этот указатель, это сообщение не публикуется. Вместо этого WM_POINTERUP размещается в окне, которое захватило этот указатель.
Внимание!
Классические приложения должны учитывать DPI. Если приложение не учитывает DPI, координаты экрана, содержащиеся в сообщениях указателя и связанных структурах, могут показаться неточными из-за виртуализации DPI. Виртуализация DPI обеспечивает поддержку автоматического масштабирования для приложений, которые не поддерживают DPI и активны по умолчанию (пользователи могут отключить его). Дополнительные сведения см. в статье Написание приложений Win32 с высоким разрешением.
WM_NCPOINTERUPDATE
Опубликовано для предоставления обновления указателя, который сделал контакт над неклиентской областью окна или при наведении указателя на незащищенный контакт перемещается над неклиентской областью окна. При наведении указателя сообщение нацелилось на любое окно, над которым находится указатель. Пока указатель находится в контакте с поверхностью, указатель неявно захватывается в окно, над которым он контактировал, и это окно продолжает получать входные данные для указателя до тех пор, пока он не разорвет контакт.
Если окно захватило этот указатель, это сообщение не публикуется. Вместо этого WM_POINTERUPDATE размещается в окне, которое захватило этот указатель.
Внимание!
Классические приложения должны учитывать DPI. Если приложение не учитывает DPI, координаты экрана, содержащиеся в сообщениях указателя и связанных структурах, могут показаться неточными из-за виртуализации DPI. Виртуализация DPI обеспечивает поддержку автоматического масштабирования для приложений, которые не поддерживают DPI и активны по умолчанию (пользователи могут отключить его). Дополнительные сведения см. в статье Написание приложений Win32 с высоким разрешением.
WM_PARENTNOTIFY
Отправляется в окно при выполнении значительного действия в окне потомка. Теперь это сообщение расширено для включения события WM_POINTERDOWN . При создании дочернего окна система отправляет WM_PARENTNOTIFY непосредственно перед функцией CreateWindow или CreateWindowEx , которая создает окно. При уничтожении дочернего окна система отправляет сообщение перед любой обработкой для уничтожения окна.
Окно получает это сообщение через функцию WindowProc .
Внимание!
Классические приложения должны учитывать DPI. Если приложение не учитывает DPI, координаты экрана, содержащиеся в сообщениях указателя и связанных структурах, могут показаться неточными из-за виртуализации DPI. Виртуализация DPI обеспечивает поддержку автоматического масштабирования для приложений, которые не поддерживают DPI и активны по умолчанию (пользователи могут отключить его). Дополнительные сведения см. в статье Написание приложений Win32 с высоким разрешением.
WM_POINTERACTIVATE
Отправляется в неактивное окно, когда основной указатель создает WM_POINTERDOWN над окном. Пока сообщение остается необработанным, оно перемещается вверх по родительской цепочке окон, пока не достигнет окна верхнего уровня. Приложения могут ответить на это сообщение, чтобы указать, требуется ли их активация.
Окно получает это сообщение через функцию WindowProc .
WM_POINTERCAPTURECHANGED
Отправляется в окно, в которое теряется запись входного указателя.
Окно получает это сообщение через функцию WindowProc .
WM_POINTERDEVICECHANGE
Отправляется в окно при изменении параметров монитора, к которому подключен дигитайзер. Это сообщение содержит сведения о масштабировании режима отображения.
WM_POINTERDEVICEINRANGE
Отправляется в окно при обнаружении устройства указателя в диапазоне входного дигитайзера. Это сообщение содержит сведения об устройстве и его близости.
WM_POINTERDEVICEOUTOFRANGE
Отправляется в окно, когда устройство с указателем покинуло диапазон дигитайзера ввода. Это сообщение содержит сведения об устройстве и его близости.
WM_POINTERDOWN
Публикуется, когда указатель устанавливает контакт над клиентской областью окна. Это входное сообщение предназначено для окна, над которым происходит контакт указателя, и указатель неявно захватывается в окно, чтобы окно продолжало получать входные данные для указателя до тех пор, пока он не разорвет контакт.
Окно получает это сообщение через функцию WindowProc .
Внимание!
Классические приложения должны учитывать DPI. Если приложение не учитывает DPI, координаты экрана, содержащиеся в сообщениях указателя и связанных структурах, могут показаться неточными из-за виртуализации DPI. Виртуализация DPI обеспечивает поддержку автоматического масштабирования для приложений, которые не поддерживают DPI и активны по умолчанию (пользователи могут отключить его). Дополнительные сведения см. в статье Написание приложений Win32 с высоким разрешением.
WM_POINTERENTER
Отправляется в окно, когда новый указатель входит в диапазон обнаружения в окне (наведение указателя мыши) или когда существующий указатель перемещается в пределах окна.
WM_POINTERLEAVE
Отправляется в окно, когда указатель покидает диапазон обнаружения над окном (наведение указателя мыши) или когда указатель перемещается за пределы окна.
WM_POINTERROUTEDAWAY
Происходит в процессе, получающего входные данные, когда входные данные указателя направляются в другой процесс.
WM_POINTERROUTEDRELEASED
Отправляется всем процессам (настроенным для цепочки между процессами через AddContentWithCrossProcessChaining и в настоящее время не обрабатывает входные данные указателя) когда-либо связан с определенным идентификатором указателя при получении сообщения WM_POINTERUP в текущем процессе.
WM_POINTERROUTEDTO
Отправляется при текущих входных данных указателя для существующего идентификатора указателя переходы от одного процесса к другому между содержимым, настроенным для межпроцессной цепочки (AddContentWithCrossProcessChaining).
WM_POINTERUP
Публикуется, когда указатель, который сделал контакт над клиентской областью окна, разрывает контакт. Это входное сообщение предназначено для окна, через которое указатель устанавливает контакт, и в этот момент указатель неявно захватывается в окно, чтобы окно продолжало получать входные сообщения, включая уведомление WM_POINTERUP для указателя, пока он не разорвет контакт.
Окно получает это сообщение через функцию WindowProc .
Внимание!
Классические приложения должны учитывать DPI. Если приложение не учитывает DPI, координаты экрана, содержащиеся в сообщениях указателя и связанных структурах, могут показаться неточными из-за виртуализации DPI. Виртуализация DPI обеспечивает поддержку автоматического масштабирования для приложений, которые не поддерживают DPI и активны по умолчанию (пользователи могут отключить его). Дополнительные сведения см. в статье Написание приложений Win32 с высоким разрешением.
WM_POINTERUPDATE
Опубликовано для предоставления обновления указателя, который соприкасался с клиентской областью окна, или на указатель, наведенный без захвата на клиентную область окна. При наведении указателя сообщение нацелилось на любое окно, над которым находится указатель. В то время как указатель находится в контакте с поверхностью, указатель неявно захватывается на окно, над которым он соприкасался, и это окно продолжает получать входные данные для указателя, пока не разорван контакт.
Внимание!
Классические приложения должны учитывать DPI. Если приложение не учитывает DPI, координаты экрана, содержащиеся в сообщениях указателя и связанных структурах, могут показаться неточными из-за виртуализации DPI. Виртуализация DPI обеспечивает поддержку автоматического масштабирования для приложений, которые не поддерживают DPI и активны по умолчанию (пользователи могут отключить его). Дополнительные сведения см. в статье Написание приложений Win32 с высоким разрешением.
WM_POINTERWHEEL
Отображается в окне с фокусом клавиатуры переднего плана при повороте колесика прокрутки.
Окно получает это сообщение через функцию WindowProc .
Внимание!
Классические приложения должны учитывать DPI. Если приложение не учитывает DPI, координаты экрана, содержащиеся в сообщениях указателя и связанных структурах, могут показаться неточными из-за виртуализации DPI. Виртуализация DPI обеспечивает поддержку автоматического масштабирования для приложений, которые не поддерживают DPI и активны по умолчанию (пользователи могут отключить его). Дополнительные сведения см. в статье Написание приложений Win32 с высоким разрешением.
WM_POINTERHWHEEL
Отображается в окне с фокусом клавиатуры переднего плана при повороте горизонтального колесика прокрутки.
Окно получает это сообщение через функцию WindowProc .
Внимание!
Классические приложения должны учитывать DPI. Если приложение не учитывает DPI, координаты экрана, содержащиеся в сообщениях указателя и связанных структурах, могут показаться неточными из-за виртуализации DPI. Виртуализация DPI обеспечивает поддержку автоматического масштабирования для приложений, которые не поддерживают DPI и активны по умолчанию (пользователи могут отключить его). Дополнительные сведения см. в статье Написание приложений Win32 с высоким разрешением.
WM_TOUCHHITTESTING
Отправляется в окно при касании, чтобы определить наиболее вероятную цель касания.

Справочник по входным сообщениям указателя