Control.MouseCaptureChanged Control.MouseCaptureChanged Control.MouseCaptureChanged Control.MouseCaptureChanged Event

Definición

Aparece cuando el control pierde la captura del mouse.Occurs when the control loses mouse capture.

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

Ejemplos

En el ejemplo de código siguiente se muestra el MouseCaptureChanged eventos para un Button control.The following code example demonstrates the MouseCaptureChanged event for a Button control.

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

Para probar este ejemplo, ejecútelo en el depurador presionando F5.To test this example, run it in the debugger by pressing F5. Abra el salida ventana de Visual Studio para que puedan ver cuando se generan eventos.Open the Output window in Visual Studio so that you can see when events are raised. Haga clic en el Button y observe el siguiente resultado.Click the Button and notice the following output.

button1_MouseDown

button1_MouseUp

button1_MouseCaptureChanged

Ahora, haga clic y mantenga presionado el botón primario del mouse el Button control.Now, click and hold the left mouse button on the Button control. Mientras sigue haciendo clic en el mouse, presione ALT + TAB para cambiar a otro programa.While still clicking the mouse, press ALT+TAB to switch to another program. Tenga en cuenta que el MouseCaptureChanged evento se produce lo que le permite controlar potencialmente este escenario.Notice that the MouseCaptureChanged event is raised enabling you to potentially handle this scenario. Dependiendo de sus acciones, el MouseUp no es posible que se produce el evento.Depending on your actions, the MouseUp event might not be raised. También puede probar esta prueba con la clave de Windows o CTRL + ESC.You can also try this test with the Windows key or CTRL+ESC.

button1_MouseDown

button1_MouseCaptureChanged

Comentarios

En casos poco frecuentes, es posible que deberá detectar entrada inesperada.In rare scenarios, you might need to detect unexpected input. Por ejemplo, considere los siguientes escenarios.For example, consider the following scenarios.

  • Durante una operación del mouse, el usuario abre el menú Inicio, presione la tecla de Windows o CTRL + ESC.During a mouse operation, the user opens the Start menu by pressing the Windows key or CTRL+ESC.

  • Durante una operación del mouse, el usuario cambia a otro programa presionando ALT+TAB.During a mouse operation, the user switches to another program by pressing ALT+TAB.

  • Durante una operación del mouse, otro programa muestra una ventana o un cuadro de mensaje que toma el foco fuera de la aplicación actual.During a mouse operation, another program displays a window or a message box that takes focus away from the current application.

Pueden incluir operaciones del mouse haciendo clic y mantenga el mouse en un formulario o un control, o realizar un mouse de la operación de arrastrar.Mouse operations can include clicking and holding the mouse on a form or a control, or performing a mouse drag operation. Si tiene que detectar cuándo un formulario o un control pierde la captura del mouse para estos y escenarios inesperados relacionados, puede usar el MouseCaptureChanged eventos.If you have to detect when a form or a control loses mouse capture for these and related unexpected scenarios, you can use the MouseCaptureChanged event.

Se aplica a