Control.MouseCaptureChanged イベント

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

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

public:
 event EventHandler ^ MouseCaptureChanged;

public event EventHandler? MouseCaptureChanged;

member this.MouseCaptureChanged : EventHandler 

Public Custom Event MouseCaptureChanged As EventHandler 

イベントの種類

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 使用できます。