Control.MouseClick Evento

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ocorre quando o usuário clica no controle com o mouse.

public:
 event System::Windows::Forms::MouseEventHandler ^ MouseClick;
public event System.Windows.Forms.MouseEventHandler MouseClick;
public event System.Windows.Forms.MouseEventHandler? MouseClick;
member this.MouseClick : System.Windows.Forms.MouseEventHandler 
Public Custom Event MouseClick As MouseEventHandler

Tipo de evento

MouseEventHandler

Exemplos

O exemplo de código a seguir demonstra o uso desse membro. No exemplo, um manipulador de eventos relata a ocorrência do MouseClick evento. Este relatório ajuda você a aprender quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.ShowConsole.WriteLine ou acrescentar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o em um projeto que contém uma instância de um tipo que herda de Control, como um Button ou ComboBox. Em seguida, nomeie a instância Control1 e verifique se o manipulador de eventos está associado ao MouseClick evento.

private void Control1_MouseClick(Object sender, MouseEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Button", e.Button );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Clicks", e.Clicks );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "X", e.X );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Y", e.Y );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Delta", e.Delta );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Location", e.Location );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "MouseClick Event" );
}

Private Sub Control1_MouseClick(sender as Object, e as MouseEventArgs) _ 
     Handles Control1.MouseClick

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Button", e.Button)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Clicks", e.Clicks)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "X", e.X)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Y", e.Y)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Delta", e.Delta)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Location", e.Location)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"MouseClick Event")

End Sub

Comentários

Deprimir um botão do mouse quando o cursor está sobre um controle normalmente gera a seguinte série de eventos do controle:

  1. MouseDown .

  2. Click .

  3. MouseClick .

  4. MouseUp .

Para que isso ocorra, os vários eventos não podem ser desabilitados na classe do controle.

Dois únicos cliques que ocorrem perto o suficiente no tempo, conforme determinado pelas configurações do mouse do sistema operacional do usuário, gerarão um MouseDoubleClick evento em vez do segundo MouseClick evento.

Importante

Os eventos Click são logicamente eventos de nível mais alto de um controle. Eles costumam ser acionados por outras ações, como pressionar a tecla ENTER quando o controle tem o foco.

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e levantando eventos.

Aplica-se a

Confira também