Control.MouseCaptureChanged Evento

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ocorre quando o controle perde a captura do mouse.

public:
 event EventHandler ^ MouseCaptureChanged;

public event EventHandler? MouseCaptureChanged;

member this.MouseCaptureChanged : EventHandler 

Public Custom Event MouseCaptureChanged As EventHandler 

Tipo de evento

EventHandler

Exemplos

O exemplo de código a seguir demonstra o MouseCaptureChanged evento para um Button controle .

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. Abra a janela Saída no Visual Studio para que você possa ver quando os eventos são gerados. Clique no Button e observe a saída a seguir.

button1_MouseDown

button1_MouseUp

button1_MouseCaptureChanged

Agora, clique e segure o botão esquerdo do mouse no Button controle. Enquanto ainda clica no mouse, pressione ALT+TAB para alternar para outro programa. Observe que o MouseCaptureChanged evento é gerado, permitindo que você potencialmente lide com esse cenário. Dependendo de suas ações, o MouseUp evento pode não ser gerado. Você também pode experimentar esse teste com a chave do Windows ou CTRL+ESC.

button1_MouseDown

button1_MouseCaptureChanged

Comentários

Em cenários raros, talvez seja necessário detectar uma entrada inesperada. Por exemplo, considere os cenários a seguir.

• Durante uma operação do mouse, o usuário abre o menu Iniciar pressionando a tecla Windows ou CTRL+ESC.

• Durante uma operação do mouse, o usuário alterna para outro programa pressionando ALT+TAB.

• Durante uma operação do mouse, outro programa exibe uma janela ou uma caixa de mensagem que tira o foco do aplicativo atual.

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 do mouse. Se você precisar detectar quando um formulário ou um controle perder a captura do mouse para esses cenários inesperados e relacionados, você poderá usar o MouseCaptureChanged evento.