MOUSEINPUT 構造体 (winuser.h)

シミュレートされたマウス イベントに関する情報が含まれます。

構文

typedef struct tagMOUSEINPUT {
  LONG      dx;
  LONG      dy;
  DWORD     mouseData;
  DWORD     dwFlags;
  DWORD     time;
  ULONG_PTR dwExtraInfo;
} MOUSEINPUT, *PMOUSEINPUT, *LPMOUSEINPUT;

メンバー

dx

型: LONG

dwFlags メンバーの値に応じて、マウスの絶対位置、または最後のマウス イベントが生成されてからのモーションの量。 絶対データは、マウスの x 座標として指定されます。相対データは、移動されたピクセル数として指定されます。

dy

型: LONG

dwFlags メンバーの値に応じて、マウスの絶対位置、または最後のマウス イベントが生成されてからのモーションの量。 絶対データは、マウスの y 座標として指定されます。相対データは、移動されたピクセル数として指定されます。

mouseData

型: DWORD

dwFlags にMOUSEEVENTF_WHEELが含まれている場合、mouseData はホイールの移動量を指定します。 正の値は、ホイールがユーザーより前方に回転したことを示します。負の値は、ユーザーに向かってホイールが後方に回転したことを示します。 1 つのホイール クリックは 、WHEEL_DELTA (120) として定義されます。

Windows Vista: dwFlags に MOUSEEVENTF_HWHEELが含まれている場合、 dwData はホイールの移動量を指定します。 正の値は、ホイールが右に回転したことを示します。負の値は、ホイールが左に回転したことを示します。 1 つのホイール クリックは 、WHEEL_DELTA (120) として定義されます。

dwFlags にMOUSEEVENTF_WHEEL、MOUSEEVENTF_XDOWN、またはMOUSEEVENTF_XUPが含まれていない場合、mouseData は 0 である必要があります。

dwFlags にMOUSEEVENTF_XDOWNまたはMOUSEEVENTF_XUPが含まれている場合、mouseData は、どの X ボタンが押されたか離されたかを指定します。 この値は、次のフラグの任意の組み合わせにすることができます。

dwFlags

型: DWORD

マウスの動きとボタンのクリックのさまざまな側面を指定するビット フラグのセット。 このメンバーのビットは、次の値の任意の妥当な組み合わせにすることができます。

マウス ボタンの状態を指定するビット フラグは、進行中の状態ではなく、状態の変更を示すように設定されます。 たとえば、マウスの左ボタンを押したまま押すと、左ボタンが最初に押されたときに MOUSEEVENTF_LEFTDOWN が設定されますが、後続のモーションには設定されません。 同様に MOUSEEVENTF_LEFTUP は、ボタンが最初に離されたときにのみ設定されます。

両方とも mouseData フィールドを使用する必要があるため、MOUSEEVENTF_WHEEL フラグと MOUSEEVENTF_XDOWN または MOUSEEVENTF_XUP フラグの両方を dwFlags パラメーターで同時に指定することはできません。

time

型: DWORD

イベントのタイム スタンプ (ミリ秒単位)。 このパラメーターが 0 の場合、システムは独自のタイム スタンプを提供します。

dwExtraInfo

種類: ULONG_PTR

マウス イベントに関連付けられている追加の値。 アプリケーションは GetMessageExtraInfo を 呼び出して、この追加情報を取得します。

解説

マウスが移動した場合は、 MOUSEEVENTF_MOVEで示され、 dx と dy はその動きに関する情報を指定します。 情報は、絶対値または相対整数値として指定されます。

MOUSEEVENTF_ABSOLUTE値を指定した場合、dx と dy には、0 ~ 65,535 の正規化された絶対座標が含まれます。 イベント プロシージャは、これらの座標を表示サーフェイスにマップします。 座標 (0,0) は、表示サーフェイスの左上隅にマップされます。座標 (65535,65535) は右下隅にマップされます。 マルチモニター システムでは、座標はプライマリ モニターにマップされます。

MOUSEEVENTF_VIRTUALDESKが指定されている場合、座標は仮想デスクトップ全体にマップされます。

MOUSEEVENTF_ABSOLUTE値が指定されていない場合、dxと dy は、前のマウス イベント (最後に報告された位置) に対する相対的な移動を指定します。 正の値は、マウスが右 (または下) に移動した場合を意味します。負の値は、マウスが左 (または上) に移動した場合を意味します。

相対的なマウスの動きは、マウス速度と 2 つのマウスしきい値の影響を受けます。 ユーザーは、コントロール パネルの [マウスのプロパティ] シートの [ポインター速度] スライダーを使用して、この 3 つの値を設定します。 これらの値は、 SystemParametersInfo 関数を使用して取得および設定できます。

システムは、指定された相対マウス移動に 2 つのテストを適用します。 x 軸または y 軸に沿って指定された距離が最初のマウスしきい値より大きく、マウス速度が 0 でない場合、システムは距離を 2 倍にします。 x 軸または y 軸に沿って指定された距離が 2 番目のマウスしきい値より大きく、マウスの速度が 2 に等しい場合、システムは最初のしきい値テストを適用した結果の距離を 2 倍にします。 したがって、x 軸または y 軸に沿って指定された相対的なマウス移動に最大 4 倍の乗算が可能になります。

要件

関連項目

概念

GetMessageExtraInfo

INPUT

キーボード入力

リファレンス

SendInput