Control.MouseClick Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando o controlo é pressionado pelo rato.
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
Exemplos
O seguinte exemplo de código demonstra a utilização deste elemento. No exemplo, um gestor de eventos reporta a ocorrência do MouseClick evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir MessageBox.Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o num projeto que contenha uma instância de um tipo que herda de Control, como um Button ou ComboBox. Depois, nomeie a instância Control1 e assegure que o gestor 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
Observações
Pressionar um botão do rato quando o cursor está sobre um controlo normalmente levanta a seguinte série de eventos a partir do controlo:
MouseDown evento.
Click evento.
MouseClick evento.
MouseUp evento.
Para que isso aconteça, os vários eventos não podem ser desativados na classe do controlo.
Dois cliques únicos que ocorrem suficientemente próximos no tempo, conforme determinado pelas definições do rato do sistema operativo do utilizador, geram um MouseDoubleClick evento em vez do segundo MouseClick evento.
Importante
Click os eventos são logicamente eventos de nível superior de um controlo. São frequentemente levantadas por outras ações, como pressionar a tecla ENTER quando o controlo está focado.
Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.