ポインター フラグ
POINTER_INFO 構造体の pointerFlags フィールドに表示できる値。
-
POINTER_FLAG_NONE
-
-
0x00000000
-
デフォルト
-
-
POINTER_FLAG_NEW
-
-
0x00000001
-
新しいポインターの到着を示します。
-
-
POINTER_FLAG_INRANGE
-
-
0x00000002
-
このポインターが引き続き存在することを示します。 このフラグが設定されていない場合は、ポインターの検出範囲が左であることを示します。
通常、このフラグは、ホバー ポインターが検出範囲を離れる (POINTER_FLAG_UPDATE が設定されている) 場合や、ウィンドウ サーフェスに接触しているポインターが検出範囲を離れる (POINTER_FLAG_UP が設定されている) 場合にのみ設定されません。
-
-
POINTER_FLAG_INCONTACT
-
-
0x00000004
-
このポインターがデジタイザー サーフェスと接触していることを示します。 このフラグが設定されていない場合は、ホバー ポインターを示します。
-
-
POINTER_FLAG_FIRSTBUTTON
-
-
0x00000010
-
マウスの左ボタンダウンに似た主要なアクションを示します。
タッチ ポインターは、デジタイザーサーフェスと接触するときにこのフラグを設定します。
ペン ポインターは、ボタンが押されていないデジタイザーサーフェスと接触しているときに、このフラグを設定します。
マウス ポインターは、マウスの左ボタンが下にあるときにこのフラグを設定します。
-
-
POINTER_FLAG_SECONDBUTTON
-
-
0x00000020
-
マウスの右ボタンダウンに似たセカンダリ アクションを示します。
タッチ ポインターでは、このフラグは使用されません。
ペン ポインターは、ペン バレル ボタンが押された状態でデジタイザーサーフェスに接触しているときに、このフラグを設定します。
マウス ポインターは、マウスの右ボタンが下にあるときにこのフラグを設定します。
-
-
POINTER_FLAG_THIRDBUTTON
-
-
0x00000040
-
マウス ホイール ボタンの下に似ています。
タッチ ポインターでは、このフラグは使用されません。
ペン ポインターでは、このフラグは使用されません。
マウス ホイール ボタンが下にあるときに、マウス ポインターにこのフラグが設定されます。
-
-
POINTER_FLAG_FOURTHBUTTON
-
-
0x00000080
-
最初の拡張マウス (XButton1) ボタンの下に似ています。
タッチ ポインターでは、このフラグは使用されません。
ペン ポインターでは、このフラグは使用されません。
マウス ポインターには、最初の拡張マウス (XBUTTON1) ボタンがダウンしているときに、このフラグが設定されます。
-
-
POINTER_FLAG_FIFTHBUTTON
-
-
0x00000100
-
2 番目の拡張マウス (XButton2) ボタンに似ています。
タッチ ポインターでは、このフラグは使用されません。
ペン ポインターでは、このフラグは使用されません。
マウス ポインターには、2 番目の拡張マウス (XBUTTON2) ボタンがダウンしているときに、このフラグが設定されます。
-
-
POINTER_FLAG_PRIMARY
-
-
0x00002000
-
このポインターがプライマリ ポインターとして指定されたことを示します。 プライマリ ポインターは、非プライマリ ポインターで使用できるアクション以外のアクションを実行できる 1 つのポインターです。 たとえば、プライマリ ポインターがウィンドウのサーフェスと接触する場合、ウィンドウに WM_POINTERACTIVATE メッセージを送信してアクティブ化する機会が提供される場合があります。
プライマリ ポインターは、システム上のすべての現在のユーザー操作 (マウス、タッチ、ペンなど) から識別されます。 そのため、プライマリ ポインターがアプリに関連付けられていない可能性があります。 マルチタッチ操作の最初の連絡先は、プライマリ ポインターとして設定されます。 プライマリ ポインターが識別されたら、新しい連絡先をプライマリ ポインターとして識別するには、すべての連絡先を解除する必要があります。 ポインター入力を処理しないアプリの場合、プライマリ ポインターのイベントのみがマウス イベントに昇格されます。
-
-
POINTER_FLAG_CONFIDENCE
-
-
0x000004000
-
信頼度は、ポインターが意図した操作または偶発的な相互作用を表すかどうかに関するソース デバイスからの提案です。これは、偶発的な相互作用 (手のひらなど) が入力をトリガーできるPT_TOUCH ポインターに特に関連します。 このフラグが存在すると、ソース デバイスは、この入力が意図した対話の一部であるという高い信頼度を持っていることを示します。
-
-
POINTER_FLAG_CANCELED
-
-
0x000008000
-
システムがポインターの無効な入力を受け取ったときや、アクティブなポインターを持つデバイスが突然離れた場合など、ポインターが異常な方法で離れていることを示します。 入力を受け取るアプリケーションがそうする位置にある場合は、相互作用を完了していないものとして扱い、関連するポインターの効果を反転させる必要があります。
-
-
POINTER_FLAG_DOWN
-
-
0x00010000
-
このポインターがダウン状態に遷移したことを示します。つまり、デジタイザーの表面に接触しました。
-
-
POINTER_FLAG_UPDATE
-
-
0x00020000
-
これは、ポインター状態の変更を含まない単純な更新であることを示します。
-
-
POINTER_FLAG_UP
-
-
0x00040000
-
このポインターがアップ状態に遷移したことを示します。つまり、デジタイザー表面との接触が終了します。
-
-
POINTER_FLAG_WHEEL
-
-
0x00080000
-
ポインター ホイールに関連付けられている入力を示します。 マウス ポインターの場合、これはマウス スクロール ホイール (WM_MOUSEHWHEEL) のアクションと同じです。
-
-
POINTER_FLAG_HWHEEL
-
-
0x00100000
-
ポインター h ホイールに関連付けられている入力を示します。 マウス ポインターの場合、これはマウスの水平スクロール ホイール (WM_MOUSEHWHEEL) のアクションと同じです。
-
-
POINTER_FLAG_CAPTURECHANGED
-
-
0x00200000
-
このポインターが別の要素によってキャプチャされ(関連付けられている)、元の要素がキャプチャを失っていることを示します (WM_POINTERCAPTURECHANGEDを参照)。
-
-
POINTER_FLAG_HASTRANSFORM
-
-
0x00400000
-
このポインターに関連付けられた変換があることを示します。
-
備考
XBUTTON1とXBUTTON2は、多くのマウス デバイスで使用される追加のボタンです。 標準のマウス ボタンと同じデータが返されます。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント |
Windows 8 [デスクトップ アプリのみ] |
サポートされている最小サーバー |
Windows Server 2012 [デスクトップ アプリのみ] |
ヘッダ |
|