Флаги сообщений указателя

Значения, используемые в различных макросах указателя (см. раздел Макросы).

POINTER_MESSAGE_FLAG_NEW

0x00000001

Указывает на появление нового указателя.

POINTER_MESSAGE_FLAG_INRANGE

0x00000002

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

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

POINTER_MESSAGE_FLAG_INCONTACT

0x00000004

Указывает, что этот указатель находится в контакте с поверхностью дигитайзера. Если этот флаг не задан, он указывает на указатель наведение указателя.

POINTER_MESSAGE_FLAG_FIRSTBUTTON

0x00000010

Указывает основное действие, аналогичное левой кнопке мыши вниз.

Для сенсорного указателя этот флаг установлен, когда он находится в контакте с поверхностью дигитайзера.

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

Этот флаг устанавливается указателем мыши, когда левая кнопка мыши находится вниз.

POINTER_MESSAGE_FLAG_SECONDBUTTON

0x00000020

Указывает дополнительное действие, аналогичное нажатию правой кнопки мыши вниз.

Сенсорный указатель не использует этот флаг.

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

Этот флаг установлен указателем мыши, когда правая кнопка мыши не работает.

POINTER_MESSAGE_FLAG_THIRDBUTTON

0x00000040

Аналогично нажатию кнопки колесика мыши.

Сенсорный указатель не использует этот флаг.

Указатель пера не использует этот флаг.

Этот флаг устанавливается указателем мыши, когда кнопка колесика мыши не работает.

POINTER_MESSAGE_FLAG_FOURTHBUTTON

0x00000080

Аналогично первой кнопке расширенной мыши (XButton1) вниз.

Сенсорный указатель не использует этот флаг.

Указатель пера не использует этот флаг.

Этот флаг устанавливается указателем мыши при отключении первой кнопки расширенной мыши (XBUTTON1).

POINTER_MESSAGE_FLAG_FIFTHBUTTON

0x00000100

Аналогично второй кнопке расширенной мыши (XButton2) вниз.

Сенсорный указатель не использует этот флаг.

Указатель пера не использует этот флаг.

Этот флаг устанавливается указателем мыши, когда вторая кнопка расширенной мыши (XBUTTON2) не работает.

POINTER_MESSAGE_FLAG_PRIMARY

0x00002000

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

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

POINTER_MESSAGE_FLAG_CONFIDENCE

0x00000400

Достоверность — это предложение от исходного устройства о том, представляет ли указатель предполагаемое или случайное взаимодействие, что особенно актуально для PT_TOUCH указателей, когда случайное взаимодействие (например, с ладони) может вызвать ввод. Наличие этого флага указывает на то, что исходное устройство имеет высокую уверенность в том, что эти входные данные являются частью предполагаемого взаимодействия.

POINTER_MESSAGE_FLAG_CANCELED

0x00000800

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

Комментарии

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

Требования

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

См. также раздел

Константы

Макросы