MouseDown、MouseUp イベント

  • [アーティクル]

ユーザーがマウス ボタンをクリックしたときに発生します。 MouseDown はユーザーがマウス ボタンを押したときに発生し、MouseUp はユーザーがマウス ボタンを離したときに発生します。

構文

マルチ ページ (MultiPage)、タブ ストリップ (TabStrip) の場合
Private Subオブジェクト _MouseDown(indexAs Long,
ByValボタンfmButton として、
ByValShiftas fmShiftState,
ByValXAs Single,
ByValYAs Single)Private Subobject _MouseUp(indexAs Long,
ByValボタンfmButton として、
ByValShiftas fmShiftState,
ByValXAs Single,
ByValYAs Single)

その他のコントロールの場合
Private Subオブジェクト _MouseDown( ByValButtonAs fmButton,
ByValShiftas fmShiftState,
ByValXAs Single,
ByValYAs Single)Private Subオブジェクト _MouseUp( ByValButtonAs fmButton,
ByValShiftas fmShiftState,
ByValXAs Single,
ByValYAs Single)

MouseDown および MouseUp イベントの構文には、次の指定項目があります。

パーツ 説明
object 必須です。 有効なオブジェクトです。
index 必須です。 指定したイベントを含む MultiPage または TabStrip のページまたはタブのインデックス。
Button 必ず指定します。 どのマウス ボタンによってイベントが発生したかを識別する整数値です。
Shift 必須。 Shift キー、Ctrl キー、および Alt キーの状態です。
X、Y 必須です。 フォーム、 Frame、または Page の左端または上端からの水平方向または垂直方向の位置をポイント単位で 指定します。

Settings

Button の設定は以下のとおりです。

定数 値 説明
fmButtonLeft 1 左ボタンが押されました。
fmButtonRight 2 右ボタンが押されました。
fmButtonMiddle 4 中央ボタンが押されました。

Shift の設定は以下のとおりです。

値 説明
1 Shift キーが押されました。
2 Ctrl キーが押されました。
3 Shift キーと Ctrl キーが押されました。
4 Alt キーが押されました。
5 Alt キーと Shift キーが押されました。
6 Alt キーと Ctrl キーが押されました。
7 Alt キー、Shift キー、Ctrl キーの 3 つが押されました。

補助キーの状態を個別に調べるには、次の定数を使用します。

定数 値 説明
fmShiftMask 1 Shift キーの検出をマスクします。
fmCtrlMask 2 Ctrl キーの検出をマスクします。
fmAltMask 4 Alt キーの検出をマスクします。

注釈

MultiPage の場合、MouseDown イベントは、ユーザーがコントロールの上でマウス ボタンを押したときに発生します。

TabStrip の場合、index 引数はユーザーがクリックしたタブを識別します。 インデックス -1 は、ユーザーがタブをクリックしなかったことを示します。たとえば、コントロールの右上隅にタブがない場合、右上隅をクリックするとインデックスが -1 に設定されます。

フォームの場合、ユーザーがフォームの空白領域、レコード セレクター、またはスクロール バーでマウス ボタンを押したり離したりすると、MouseDown および MouseUp イベントが発生します。

一連のマウス関連のイベントは以下のとおりです。

  1. MouseDown
  2. MouseUp
  3. Click
  4. DblClick
  5. MouseUp

MouseDown または MouseUp イベント プロシージャーでは、マウス ボタンが押されるか離されたときに発生するアクションを指定します。 MouseDown および MouseUp イベントを使用すると、マウスの左ボタン、右ボタン、および中央ボタンを区別できます。 また、Shift、Ctrl、および Alt キーボード修飾子と組み合わせて、マウス ボタンが操作されたときの処理を記述することもできます。

マウス ポインターがフォームやコントロール上にあるときにマウス ボタンがクリックされると、そのオブジェクトは、最後の MouseUp イベントが発生するまで (このイベントを含め)、マウスを "キャプチャ" し、マウスに関連するすべてのイベントを受け取ります。 つまり、マウス イベントによって返される X、Y マウス ポインター座標は、その座標を受け取ったオブジェクトの境界内に常に含まれるとは限りません。

マウス ボタンが連続して押された場合、マウスをキャプチャしたオブジェクトは、すべてのマウス ボタンが離された状態になるまですべての連続するマウス イベントを受け取ります。

Shift 引数を使用して、MouseDown または MouseUp イベントが発生したときの Shift キー、Ctrl キー、および Alt キーの状態を識別します。 たとえば、Ctrl キーと Alt キーの両方が押された場合、Shift の値は 6 になります。

関連項目

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。