PacketPropertyGuids 常量

定义指定数据包属性的值。 Tablet PCAPI 使用全局唯一标识符 (GUID) 来标识数据包属性，COM 中的数据包属性是常量字符串。

在 C++ 中，可以在 Msinkaut.h 头文件中访问这些常量，如果在默认位置安装了 SDK，该文件位于 <systemdrive>：\Program Files\Microsoft SDKs\Windows\v6.0\Include 目录中。 在 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) 。 游标是反转的。 例如，笔的橡皮擦端指向表面， (Value = 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	用于标识数据包的 packet 属性。 此值与用于从数据包队列检索数据包的值相同。
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	指示笔尖位于垂直于书写图面的水平线上方还是下方的数据包属性。 注意： 这需要 3D 数字化器。 如果笔尖位于线条上方，则值为正值，如果位于线条下方，则值为负值。 例如，如果你将笔放在你面前，在虚构的墙上书写，如果笔尖位于从你到墙壁的一条线上方，则间距为正值。
STR_GUID_ROLLROTATION或GUID_PACKETPROPERTY_GUID_ROLL_ROTATION	笔围绕其自身轴的顺时针旋转。 注意： 这需要 3D 数字化器。
STR_GUID_YAWROTATION或GUID_PACKETPROPERTY_GUID_YAW_ROTATION	当笔处于水平时，笔向左或向右围绕其水平轴中心的角度。 注意： 这需要 3D 数字化器。 如果将触控笔放在前面并在虚墙上书写，则零偏航指示笔与墙壁垂直。 如果笔尖位于垂直的左侧，则值为负值;如果笔尖位于垂直的右侧，则值为正值。
STR_GUID_YAWROTATION或GUID_PACKETPROPERTY_GUID_YAW_ROTATION	当笔处于水平时，笔向左或向右围绕其水平轴中心的角度。 注意： 这需要 3D 数字化器。 如果将触控笔放在前面并在虚墙上书写，则零偏航指示笔与墙壁垂直。 如果笔尖位于垂直的左侧，则值为负值;如果笔尖位于垂直的右侧，则值为正值。
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 接口