Control.MouseCaptureChanged Evento

Definição

Ocorre quando o controle perde a captura do 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 

Exemplos

O exemplo de código a seguir demonstra o evento MouseCaptureChanged para um controle de Button.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 testar este exemplo, execute-o no depurador pressionando F5.To test this example, run it in the debugger by pressing F5. Abra a janela saída no Visual Studio para que você possa ver quando os eventos são gerados.Open the Output window in Visual Studio so that you can see when events are raised. Clique no Button e observe a saída a seguir.Click the Button and notice the following output.

button1_MouseDown

button1_MouseUp

button1_MouseCaptureChanged

Agora, clique e mantenha o botão esquerdo do mouse no controle de Button.Now, click and hold the left mouse button on the Button control. Enquanto ainda estiver clicando no mouse, pressione ALT + TAB para alternar para outro programa.While still clicking the mouse, press ALT+TAB to switch to another program. Observe que o evento MouseCaptureChanged é gerado, permitindo que você manipule esse cenário potencialmente.Notice that the MouseCaptureChanged event is raised enabling you to potentially handle this scenario. Dependendo de suas ações, o evento MouseUp pode não ser gerado.Depending on your actions, the MouseUp event might not be raised. Você também pode tentar esse teste com a tecla Windows ou CTRL + ESC.You can also try this test with the Windows key or CTRL+ESC.

button1_MouseDown

button1_MouseCaptureChanged

Comentários

Em casos raros, talvez seja necessário detectar entradas inesperadas.In rare scenarios, you might need to detect unexpected input. Por exemplo, considere os cenários a seguir.For example, consider the following scenarios.

  • Durante uma operação do mouse, o usuário abre o menu iniciar pressionando a tecla Windows ou CTRL + ESC.During a mouse operation, the user opens the Start menu by pressing the Windows key or CTRL+ESC.

  • Durante uma operação do mouse, o usuário alterna para outro programa pressionando ALT + TAB.During a mouse operation, the user switches to another program by pressing ALT+TAB.

  • Durante uma operação do mouse, outro programa exibe uma janela ou uma caixa de mensagem que fica concentrada fora do aplicativo atual.During a mouse operation, another program displays a window or a message box that takes focus away from the current application.

As operações do mouse podem incluir clicar e segurar o mouse em um formulário ou um controle ou executar uma operação de arrastar com o mouse.Mouse operations can include clicking and holding the mouse on a form or a control, or performing a mouse drag operation. Se você tiver que detectar quando um formulário ou um controle perde a captura do mouse para esses cenários inesperados e relacionados, você pode usar o evento MouseCaptureChanged.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.

Aplica-se a