Control.Click Evento

Definição

Ocorre quando o comando é carregado.

public:
 event EventHandler ^ Click;
public event EventHandler Click;
public event EventHandler? Click;
member this.Click : EventHandler 
Public Custom Event Click As EventHandler 

Tipo de Evento

Exemplos

O seguinte exemplo de código mostra o Click evento num gestor de eventos.

   // This example uses the Parent property and the Find method of Control to set
   // properties on the parent control of a Button and its Form. The example assumes
   // that a Button control named button1 is located within a GroupBox control. The 
   // example also assumes that the Click event of the Button control is connected to
   // the event handler method defined in the example.
private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Get the control the Button control is located in. In this case a GroupBox.
      Control^ control = button1->Parent;
      
      // Set the text and backcolor of the parent control.
      control->Text = "My Groupbox";
      control->BackColor = Color::Blue;
      
      // Get the form that the Button control is contained within.
      Form^ myForm = button1->FindForm();
      
      // Set the text and color of the form containing the Button.
      myForm->Text = "The Form of My Control";
      myForm->BackColor = Color::Red;
   }
// This example uses the Parent property and the Find method of Control to set
// properties on the parent control of a Button and its Form. The example assumes
// that a Button control named button1 is located within a GroupBox control. The 
// example also assumes that the Click event of the Button control is connected to
// the event handler method defined in the example.
private void button1_Click(object sender, System.EventArgs e)
{
   // Get the control the Button control is located in. In this case a GroupBox.
   Control control = button1.Parent;
   // Set the text and backcolor of the parent control.
   control.Text = "My Groupbox";
   control.BackColor = Color.Blue;
   // Get the form that the Button control is contained within.
   Form myForm = button1.FindForm();
   // Set the text and color of the form containing the Button.
   myForm.Text = "The Form of My Control";
   myForm.BackColor = Color.Red;
}
' This example uses the Parent property and the Find method of Control to set
' properties on the parent control of a Button and its Form. The example assumes
' that a Button control named button1 is located within a GroupBox control. The 
' example also assumes that the Click event of the Button control is connected to
' the event handler method defined in the example.
Private Sub button1_Click(sender As Object, e As System.EventArgs) Handles button1.Click
   ' Get the control the Button control is located in. In this case a GroupBox.
   Dim control As Control = button1.Parent
   ' Set the text and backcolor of the parent control.
   control.Text = "My Groupbox"
   control.BackColor = Color.Blue
   ' Get the form that the Button control is contained within.
   Dim myForm As Form = button1.FindForm()
   ' Set the text and color of the form containing the Button.
   myForm.Text = "The Form of My Control"
   myForm.BackColor = Color.Red
End Sub

Observações

O Click evento passa um EventArgs para o seu gestor de eventos, pelo que apenas indica que ocorreu um clique. Se precisares de informações mais específicas do rato (botão, número de cliques, rotação da roda ou localização), usa o MouseClick evento. No entanto, o MouseClick evento não será ativado se o clique for causado por uma ação diferente da do rato, como pressionar a tecla ENTER.

Um duplo clique é determinado pelas definições do rato do sistema operativo do utilizador. O utilizador pode definir o tempo entre cliques de um botão do rato que deve ser considerado um duplo clique em vez de dois cliques. O Click evento é ativado sempre que um controlo é clicado duas vezes. Por exemplo, se tiver manipuladores de eventos para os Click eventos e DoubleClick de um Form, os Click eventos e DoubleClick são levantados quando o formulário é clicado duas vezes e ambos os métodos são chamados. Se um controlo for clicado duas vezes e esse controlo não suportar o DoubleClick evento, o Click evento pode ser levantado duas vezes.

Deve definir o StandardClick valor de ControlStyles para true que este evento seja aumentado.

Note

Os seguintes eventos não são levantados para a TabControl classe a menos que haja pelo menos um TabPage na TabControl.TabPages coleção: Click, DoubleClick, MouseDown, MouseUp, MouseHover, MouseEnter, , e MouseLeaveMouseMove. Se houver pelo menos um TabPage na coleção, e o utilizador interagir com o cabeçalho do controlo tab (onde aparecem os TabPage nomes), o TabControl evento apropriado é gerado. No entanto, se a interação do utilizador estiver dentro da área do cliente da página de separador, o TabPage evento apropriado é gerado.

Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.

Notas aos herdeiros

Herdar de um controlo Windows Forms padrão e alterar os valores StandardClick ou StandardDoubleClick de ControlStyles para true pode causar comportamentos inesperados ou não ter qualquer efeito se o controlo não suportar os eventos Click ou DoubleClick.

A tabela seguinte lista Windows Forms controlos e qual o evento (Click ou DoubleClick) é levantado em resposta à ação do rato especificada.

Controlo Clique Esquerdo do Rato Clique duplo do rato esquerdo Clique Direito do Rato Duplo clique direito do rato Clique do Meio do Rato Clique Duplo do Rato do Meio XButton1 Clique do Rato Rato XButton1 Double-Click XButton2 Clique do Rato Rato XButton2 Double-Click
MonthCalendar, DateTimePicker, HScrollBar, VScrollBar nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma
Button, CheckBox, RichTextBox, RadioButton Clique Clique, Clique nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma
ListBox, CheckedListBox, ComboBox Clique Clique, Duplo Clique nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma
TextBox, DomainUpDown, NumericUpDown Clique Clique, Duplo Clique nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma
* TreeView, * ListView Clique Clique, Duplo Clique Clique Clique, Duplo Clique nenhuma nenhuma nenhuma nenhuma nenhuma nenhuma
ProgressBar, TrackBar Clique Clique, Clique Clique Clique, Clique Clique Clique, Clique Clique Clique, Clique Clique Clique, Clique
Form, , , , , , DataGrid, Label** LinkLabelPanelGroupBoxPictureBoxSplitterStatusBarToolBarTabPageTabControl Clique Clique, Duplo Clique Clique Clique, Duplo Clique Clique Clique, Duplo Clique Clique Clique, Duplo Clique Clique Clique, Duplo Clique

* O ponteiro do rato deve estar sobre um objeto filho (TreeNode ou ListViewItem).

** Deve TabControl ter pelo menos um TabPage na sua TabPages coleção.

Aplica-se a

Ver também