Control.MouseCaptureChanged Evento

public:
 event EventHandler ^ MouseCaptureChanged;

public event EventHandler MouseCaptureChanged;

member this.MouseCaptureChanged : EventHandler 

Public Custom Event MouseCaptureChanged As EventHandler 

Tipo de Evento

Exemplos

O exemplo de código seguinte demonstra o MouseCaptureChanged evento para um Button controlo.

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 Output no Visual Studio para que possa ver quando os eventos são ativados. Clique em e Button repare no seguinte resultado.

button1_MouseDown

button1_MouseUp

button1_MouseCaptureChanged

Agora, clique e mantenha pressionado o botão esquerdo do rato no Button controlo. Enquanto continua a clicar com o rato, pressione ALT+TAB para mudar para outro programa. Note que o MouseCaptureChanged evento é elevado, permitindo-lhe potencialmente lidar com este cenário. Dependendo das tuas ações, o MouseUp evento pode não ser levantado. Também podes tentar este teste com a tecla Windows ou CTRL+ESC.

button1_MouseDown

button1_MouseCaptureChanged

Observações

Em cenários raros, pode ser necessário detetar entradas inesperadas. Por exemplo, considere os seguintes cenários.

• Durante uma operação com rato, o utilizador abre o menu Iniciar pressionando a tecla Windows ou CTRL+ESC.

• Durante uma operação com rato, o utilizador muda para outro programa pressionando ALT+TAB.

• Durante uma operação com rato, outro programa apresenta uma janela ou uma caixa de mensagens que desvia o foco da aplicação atual.

As operações com rato podem incluir clicar e manter o rato pressionado num formulário ou controlo, ou realizar uma operação de arrastar do rato. Se tiver de detetar quando um formulário ou controlo perde a captura do rato para estes e cenários inesperados relacionados, pode usar o MouseCaptureChanged evento.