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

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

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 являются дополнительными кнопками, используемыми на многих устройствах мыши. Они возвращают те же данные, что и стандартные кнопки мыши.

Требования

См. также

константы

макросы