Константы PacketPropertyGuids

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

В C++ эти константы можно получить в файле заголовка Msinkaut.h, который находится в каталоге <systemdrive>:\Program Files\Microsoft SDKs\Windows\v6.0\Include, если пакет SDK установлен в расположении по умолчанию. В C++ эти константы являются WCHAR, а не BSTR. Преобразуйте их в BSTR перед использованием. Дополнительные сведения о типе данных BSTR см. в разделе Использование библиотеки COM.

В следующей таблице перечислены доступные поля глобального уникального идентификатора (GUID) свойства пакета. Используйте эти идентификаторы GUID, чтобы указать, какие свойства содержит пакет при создании контекста планшета. Чтобы определить диапазон и разрешение свойства, вызовите метод GetPropertyMetrics . Константы в приведенной ниже таблице, начинающиеся с "STR_", являются строковыми представлениями соответствующих двоичных констант, отображаемых в той же ячейке таблицы.

Константа Описание
STR_GUID_X или GUID_PACKETPROPERTY_GUID_X
Координата X в пространстве координат планшета. Каждый пакет по умолчанию содержит это свойство. Источником (0,0) планшета является левый верхний угол.
STR_GUID_Y или GUID_PACKETPROPERTY_GUID_Y
Координата Y в пространстве координат планшета. Каждый пакет по умолчанию содержит это свойство. Источником (0,0) планшета является левый верхний угол.
STR_GUID_Y или GUID_PACKETPROPERTY_GUID_Y
Координата Y в пространстве координат планшета. Каждый пакет по умолчанию содержит это свойство. Источником (0,0) планшета является левый верхний угол.
STR_GUID_Z или GUID_PACKETPROPERTY_GUID_Z
Координата Z или расстояние кончика пера от поверхности планшета. Тип перечисления TabletPropertyMetricUnit определяет единицу измерения для этого свойства.
STR_GUID_PAKETSTATUS или GUID_PACKETPROPERTY_GUID_PACKET_STATUS
Содержит одно или несколько следующих значений флагов:
  • Курсор касается поверхности рисования (значение = 1).
  • Курсор инвертирован. Например, конец пера ластика указывает на поверхность (значение = 2).
  • Не используется (значение = 4).
  • Кнопка "Бочка" нажата (значение = 8).
STR_GUID_TIMERTICK или GUID_PACKETPROPERTY_GUID_TIMER_TICK
Время создания пакета.
STR_GUID_TIMERTICK или GUID_PACKETPROPERTY_GUID_TIMER_TICK
Время создания пакета.
STR_GUID_SERIALNUMBER или GUID_PACKETPROPERTY_GUID_SERIAL_NUMBER
Свойство пакета для идентификации пакета.
Это то же значение, которое используется для извлечения пакета из очереди пакетов.
STR_GUID_NORMALPRESSURE или GUID_PACKETPROPERTY_GUID_NORMAL_PRESSURE
Давление кончика перпендикулярно поверхности планшета.
Чем больше давление на кончик пера, тем больше рукописного ввода.
STR_GUID_TANGENTPRESSURE или GUID_PACKETPROPERTY_GUID_TANGENT_PRESSURE
Давление кончика пера вдоль плоскости поверхности планшета.
STR_GUID_BUTTONPRESSURE или GUID_PACKETPROPERTY_GUID_BUTTON_PRESSURE
Давление на кнопку, чувствительную к нажатию.
STR_GUID_XTILTORIENTATION или GUID_PACKETPROPERTY_GUID_X_TILT_ORIENTATION
Угол между плоскостью y,z и пером и плоскостью оси Y.
Применяется к курсору пера.
Значение равно 0, если перо перпендикулярно поверхности рисунка, и является положительным, если перо находится справа от перпендикулярности.
STR_GUID_YTILTORIENTATION или GUID_PACKETPROPERTY_GUID_Y_TILT_ORIENTATION
Угол между плоскостью x,z и пером и плоскостью оси X.
Применяется к курсору пера.
Значение равно 0, если перо перпендикулярно поверхности рисования, и является положительным, когда перо находится вверх или от пользователя.
STR_GUID_AZIMUTHORIENTATION или GUID_PACKETPROPERTY_GUID_AZIMUTH_ORIENTATION
Поворот курсора по оси Z по часовой стрелке через полный циклический диапазон.
STR_GUID_ALTITUDEORIENTATION или GUID_PACKETPROPERTY_GUID_ALTITUDE_ORIENTATION
Угол между осью пера и поверхностью планшета.
Значение равно 0, если перо параллельно поверхности, и 90, если перпендикулярно поверхности.
При инвертировании пера значения являются отрицательными.
STR_GUID_TWISTORIENTATION или GUID_PACKETPROPERTY_GUID_TWIST_ORIENTATION
Поворот курсора по часовой стрелке относительно его собственной оси.
STR_GUID_PITCHROTATION или GUID_PACKETPROPERTY_GUID_PITCH_ROTATION
Свойство пакета, указывающее, находится ли кончик выше или ниже горизонтальной линии, перпендикулярной поверхности записи.
Примечание: Для этого требуется трехмерный дигитайзер.
Значение является положительным, если наконечник находится над строкой, и отрицательным, если он находится ниже строки. Например, если вы держите ручку перед собой и пишете на воображаемой стене, шаг будет положительным, если наконечник находится над линией, простирающейся от вас до стены.
STR_GUID_ROLLROTATION или GUID_PACKETPROPERTY_GUID_ROLL_ROTATION
Поворот пера по часовой стрелке вокруг собственной оси.
Примечание: Для этого требуется трехмерный дигитайзер.
STR_GUID_YAWROTATION или GUID_PACKETPROPERTY_GUID_YAW_ROTATION
Угол пера влево или вправо вокруг центра горизонтальной оси, когда перо является горизонтальным.
Примечание: Для этого требуется трехмерный дигитайзер.
Если вы держите перо перед собой и пишете на воображаемой стене, нулевое порывение означает, что перпендикулярно стене. Значение является отрицательным, если кончик находится слева от перпендикулярной, и положительным, если кончик находится справа от перпендикулярной.
STR_GUID_YAWROTATION или GUID_PACKETPROPERTY_GUID_YAW_ROTATION
Угол пера влево или вправо вокруг центра горизонтальной оси, когда перо является горизонтальным.
Примечание: Для этого требуется трехмерный дигитайзер.
Если вы держите перо перед собой и пишете на воображаемой стене, нулевое порывение означает, что перпендикулярно стене. Значение является отрицательным, если кончик находится слева от перпендикулярной, и положительным, если кончик находится справа от перпендикулярной.
STR_GUID_WIDTH или GUID_PACKETPROPERTY_GUID_WIDTH
Ширина области контакта в дигитайзере сенсорного ввода.
STR_GUID_HEIGHT или GUID_PACKETPROPERTY_GUID_HEIGHT
Высота области контакта на дигитайзере сенсорного ввода.
STR_GUID_FINGERCONTACTCONFIDENCE или GUID_PACKETPROPERTY_GUID_FINGERCONTACTCONFIDENCE
Уровень уверенности в том, что контакт пальца на сенсорном дигитайзере.
STR_GUID_DEVICE_CONTACT_ID или GUID_PACKETPROPERTY_GUID_DEVICE_CONTACT_ID
Идентификатор контакта устройства для пакета.

Комментарии

Примечание

Все значения пакетов, поступающие от оборудования планшета, представляют собой 32-разрядные целые числа.

 

Требования

Требование Значение
Минимальная версия клиента
Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера
Ни одна версия не поддерживается
Заголовок
Msinkaut.h (также требуется Msinkaut_i.c)

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

Метод IsPacketPropertySupported

Метод GetPropertyMetrics

Интерфейс IInkTablet