ポインターメッセージフラグ

さまざまなポインターマクロで使用される値 (マクロを参照)。

POINTER_MESSAGE_FLAG_NEW

POINTER_MESSAGE_FLAG_INRANGE

0x00000002
このポインターが引き続き存在することを示します。このフラグが設定されていない場合は、ポインターの検出範囲が左であることを示します。

通常、このフラグは、ホバーポインターが検出範囲を離れる (POINTER_FLAG_UPDATE が設定されている) 場合や、ウィンドウサーフェスに接触しているポインターが検出範囲を離れる (POINTER_FLAG_UP が設定されている) 場合にのみ設定されません。

POINTER_MESSAGE_FLAG_INCONTACT

POINTER_MESSAGE_FLAG_FIRSTBUTTON

0x00000010
マウスの左ボタンダウンに似た主要なアクションを示します。 タッチポインターは、デジタイザーサーフェスと接触するときにこのフラグを設定します。 ペンポインターは、ボタンが押されていないデジタイザーサーフェスと接触しているときに、このフラグを設定します。 マウスポインターは、マウスの左ボタンが下にあるときにこのフラグを設定します。

POINTER_MESSAGE_FLAG_SECONDBUTTON

0x00000020
マウスの右ボタンダウンに似たセカンダリアクションを示します。 タッチポインターでは、このフラグは使用されません。 ペンポインターは、ペンバレルボタンが押された状態でデジタイザーサーフェスに接触しているときに、このフラグを設定します。 マウスポインターは、マウスの右ボタンが下にあるときにこのフラグを設定します。

POINTER_MESSAGE_FLAG_THIRDBUTTON

0x00000040
マウスホイールボタンの下に似ています。 タッチポインターでは、このフラグは使用されません。 ペンポインターでは、このフラグは使用されません。 マウスホイールボタンが下にあるときに、マウスポインターにこのフラグが設定されます。

POINTER_MESSAGE_FLAG_FOURTHBUTTON

0x00000080
最初の拡張マウス (XButton1) ボタンの下に似ています。 タッチポインターでは、このフラグは使用されません。 ペンポインターでは、このフラグは使用されません。 マウスポインターには、最初の拡張マウス (XBUTTON1) ボタンがダウンしているときに、このフラグが設定されます。

POINTER_MESSAGE_FLAG_FIFTHBUTTON

0x00000100
2 番目の拡張マウス (XButton2) ボタンに似ています。 タッチポインターでは、このフラグは使用されません。 ペンポインターでは、このフラグは使用されません。 マウスポインターには、2 番目の拡張マウス (XBUTTON2) ボタンがダウンしているときに、このフラグが設定されます。

POINTER_MESSAGE_FLAG_PRIMARY

0x00002000
このポインターがプライマリポインターとして指定されたことを示します。プライマリポインターは、非プライマリポインターで使用できるアクション以外のアクションを実行できる 1 つのポインターです。たとえば、プライマリポインターがウィンドウのサーフェスと接触する場合、ウィンドウにWM_POINTERACTIVATEメッセージを送信してアクティブ化する機会が提供される場合があります。 プライマリポインターは、システム上のすべての現在のユーザー操作 (マウス、タッチ、ペンなど) から識別されます。そのため、プライマリポインターがアプリに関連付けられていない可能性があります。マルチタッチ操作の最初の連絡先は、プライマリポインターとして設定されます。プライマリポインターが識別されたら、新しい連絡先をプライマリポインターとして識別するには、すべての連絡先を解除する必要があります。ポインター入力を処理しないアプリの場合、プライマリポインターのイベントのみがマウスイベントに昇格されます。

POINTER_MESSAGE_FLAG_CONFIDENCE

0x00000400
信頼度は、ポインターが意図した操作または偶発的な相互作用を表すかどうかに関するソースデバイスからの提案です。これは、偶発的な相互作用 (手のひらなど) が入力をトリガーできるPT_TOUCH ポインターに特に関連します。このフラグが存在すると、ソースデバイスは、この入力が意図した対話の一部であるという高い信頼度を持っていることを示します。

POINTER_MESSAGE_FLAG_CANCELED

0x00000800
システムがポインターの無効な入力を受け取ったときや、アクティブなポインターを持つデバイスが突然離れた場合など、ポインターが異常な方法で離れていることを示します。入力を受け取るアプリケーションがそうする位置にある場合は、相互作用を完了していないものとして扱い、関連するポインターの効果を反転させる必要があります。

備考

XBUTTON1とXBUTTON2は、多くのマウスデバイスで使用される追加のボタンです。標準のマウスボタンと同じデータが返されます。