Control.MouseCaptureChanged イベント

定義

コントロールがマウスのキャプチャを失うと発生します。

public:
 event EventHandler ^ MouseCaptureChanged;
public event EventHandler MouseCaptureChanged;
public event EventHandler? MouseCaptureChanged;
member this.MouseCaptureChanged : EventHandler 
Public Custom Event MouseCaptureChanged As EventHandler 

イベントの種類

次のコード例は、コントロールの MouseCaptureChanged イベントを Button 示しています。

private void button1_MouseDown(object sender, MouseEventArgs e)
{
    System.Diagnostics.Debug.WriteLine("button1_MouseDown");
}

private void button1_MouseUp(object sender, MouseEventArgs e)
{
    System.Diagnostics.Debug.WriteLine("button1_MouseUp");
}

private void button1_MouseCaptureChanged(object sender, EventArgs e)
{
    System.Diagnostics.Debug.WriteLine("button1_MouseCaptureChanged");
}
Private Sub Button1_MouseDown(ByVal sender As System.Object, _
ByVal e As MouseEventArgs) Handles Button1.MouseDown
    Debug.WriteLine("Button1_MouseDown")
End Sub

Private Sub Button1_MouseUp(ByVal sender As System.Object, _
ByVal e As MouseEventArgs) Handles Button1.MouseUp
    Debug.WriteLine("Button1_MouseUp")
End Sub

Private Sub Button1_MouseCaptureChanged(ByVal sender As System.Object, _
ByVal e As EventArgs) Handles Button1.MouseCaptureChanged
    Debug.WriteLine("Button1_MouseCaptureChanged")
End Sub

この例をテストするには、F5 キーを押してデバッガーで実行します。 Visual Studio で [出力 ] ウィンドウを開き、イベントが発生したタイミングを確認できるようにします。 を Button クリックすると、次の出力が表示されます。

button1_MouseDown

button1_MouseUp

button1_MouseCaptureChanged

次に、コントロールのマウスの左ボタンをクリックしたままにします Button 。 マウスをクリックしたまま、Alt キーを押しながら Tab キーを押して別のプログラムに切り替えます。 イベントが MouseCaptureChanged 発生し、このシナリオを処理できる可能性があることに注意してください。 アクションによっては、イベントが MouseUp 発生しない場合があります。 Windows キーまたは Ctrl + ESC キーを使用して、このテストを試すこともできます。

button1_MouseDown

button1_MouseCaptureChanged

注釈

まれなシナリオでは、予期しない入力を検出することが必要になる場合があります。 たとえば、次のシナリオを考えてみましょう。

  • マウス操作中に、ユーザーは Windows キーまたは Ctrl + ESC キーを押して [スタート] メニューを開きます。

  • マウス操作中に、ユーザーは Alt キーを押しながら Tab キーを押して別のプログラムに切り替えます。

  • マウス操作中に、別のプログラムによって、現在のアプリケーションからフォーカスを取り除くウィンドウまたはメッセージ ボックスが表示されます。

マウス操作には、フォームまたはコントロールでマウスをクリックして押したままにしたり、マウスドラッグ操作を実行したりできます。 これらの予期しないシナリオや関連する予期しないシナリオで、フォームまたはコントロールがマウス キャプチャを失ったときに検出する必要がある場合は、 イベントを MouseCaptureChanged 使用できます。

適用対象