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

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

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 は、多くのマウスデバイスで使用される追加のボタンです。標準のマウスボタンと同じデータが返されます。