PacketPropertyGuids 定数

  • [アーティクル]

パケットのプロパティを指定する値を定義します。 Tablet PCAPI は、グローバル一意識別子 (GUID) を使用して、COM 内の定数文字列であるパケット プロパティを識別します。

C++ では、既定の場所に SDK をインストールした場合は、 <systemdrive>:\Program Files\Microsoft SDKs\Windows\v6.0\Include ディレクトリにある Msinkaut.h ヘッダー ファイル内のこれらの定数にアクセスできます。 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 つ以上が含まれます。
  • カーソルが描画サーフェイスに触れている (値 = 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
 パケットを識別するための 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
 書き込みサーフェスに垂直な水平線の上または下に先端があるかどうかを示す packet プロパティ。
メモ： これには、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 タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー
 サポートなし
ヘッダー
Msinkaut.h (Msinkaut_i.c も必要)

関連項目

IsPacketPropertySupported メソッド

GetPropertyMetrics メソッド

IInkTablet インターフェイス