PacketPropertyGuids 常數

定義指定封包屬性的值。 平板電腦 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	包含下列一或多個旗標值： 游標會觸碰繪圖介面， (Value = 1) 。 資料指標會反轉。 例如，畫筆的橡皮擦結尾指向表面 (Value = 2) 。 未使用 (Value = 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	封包屬性，指出小費在寫入表面垂直的水平線上方或下方。 注意： 這需要 3D 數位板。 如果小費在行上方，則此值為正值，如果其位於行下方，則為負值。 例如，如果您將手寫筆放在您前面，並在虛牆上寫入，則如果小費在從您延伸至牆的線條上方，則音調為正值。
STR_GUID_ROLLROTATION或GUID_PACKETPROPERTY_GUID_ROLL_ROTATION	手寫筆繞著自己的軸順時針旋轉。 注意： 這需要 3D 數位板。
STR_GUID_YAWROTATION或GUID_PACKETPROPERTY_GUID_YAW_ROTATION	手寫筆在水準手寫筆時，其水準軸中央或右邊的畫筆角度。 注意： 這需要 3D 數位板。 如果您將手寫筆放在您前面，並在虛構的牆上寫入，則零 yaw 表示畫筆與牆垂直。 如果小費位於垂直左邊，則值為負值，如果小費位於垂直右邊，則為正值。
STR_GUID_YAWROTATION或GUID_PACKETPROPERTY_GUID_YAW_ROTATION	手寫筆在水準手寫筆時，其水準軸中央或右邊的畫筆角度。 注意： 這需要 3D 數位板。 如果您將手寫筆放在您前面，並在虛構的牆上寫入，則零 yaw 表示畫筆與牆垂直。 如果小費位於垂直左邊，則值為負值，如果小費位於垂直右邊，則為正值。
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 介面