Control.Click 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 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.