Control.Click Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre quando o controle é clicado.
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 exemplo de código a seguir mostra o Click evento em um manipulador 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
Comentários
O Click evento passa um EventArgs para seu manipulador de eventos, portanto, ele indica apenas que ocorreu um clique. Se você precisar de informações mais específicas do mouse (botão, número de cliques, rotação de roda ou local), use o MouseClick evento. No entanto, o MouseClick evento não será gerado se o clique for causado por uma ação diferente da do mouse, como pressionar a tecla ENTER.
Um clique duplo é determinado pelas configurações do mouse do sistema operacional do usuário. O usuário pode definir o tempo entre cliques de um botão do mouse que deve ser considerado um clique duplo em vez de dois cliques. O Click evento é gerado sempre que um controle é clicado duas vezes. Por exemplo, se você tiver manipuladores de eventos para os Click eventos e DoubleClick eventos de umForm, os eventos e Click os DoubleClick eventos serão gerados quando o formulário for clicado duas vezes e ambos os métodos forem chamados. Se um controle for clicado duas vezes e esse controle não oferecer suporte ao DoubleClick evento, o Click evento poderá ser gerado duas vezes.
Você deve definir o StandardClick valor para ControlStylestrue esse evento a ser gerado.
Note
Os eventos a seguir não são gerados para a classe, TabControl a menos que haja pelo menos um TabPage na TabControl.TabPages coleção: Click, , DoubleClick, MouseDown, MouseUp, , MouseHover, MouseEntere MouseLeaveMouseMove. Se houver pelo menos um TabPage na coleção e o usuário interagir com o cabeçalho do controle de tabulação (em que os TabPage nomes aparecem), o TabControl evento será gerado. No entanto, se a interação do usuário estiver dentro da área do cliente da página de tabulação, ele gerará TabPage o evento apropriado.
Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.
Anotações aos herdadores
Herdar de um controle de Windows Forms padrão e alterar os valores StandardClick ou StandardDoubleClick de ControlStyles para true poderá causar comportamento inesperado ou não ter nenhum efeito se o controle não der suporte aos eventos Click ou DoubleClick.
A tabela a seguir lista Windows Forms controles e qual evento (Click ou DoubleClick) é gerado em resposta à ação do mouse especificada.
| Controle | Clique no mouse à esquerda | Clique duplo do mouse à esquerda | Clique com o botão direito do mouse | Clique duas vezes no mouse com o botão direito do mouse | Clique no mouse do meio | Clique duplo do mouse do meio | Clique no mouse do XButton1 | Double-Click do mouse XButton1 | Clique no mouse XButton2 | Double-Click de mouse XButton2 |
|---|---|---|---|---|---|---|---|---|---|---|
| MonthCalendar, DateTimePicker, , HScrollBarVScrollBar | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum |
| Button, CheckBox, , RichTextBoxRadioButton | Clique em | Clique, clique em | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum |
| ListBox, , CheckedListBoxComboBox | Clique em | Clique em DoubleClick | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum |
| TextBox, , DomainUpDownNumericUpDown | Clique em | Clique em DoubleClick | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum |
| * TreeView, * ListView | Clique em | Clique em DoubleClick | Clique em | Clique em DoubleClick | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum | Nenhum |
| ProgressBar, TrackBar | Clique em | Clique, clique em | Clique em | Clique, clique em | Clique em | Clique, clique em | Clique em | Clique, clique em | Clique em | Clique, clique em |
| Form, DataGrid, Label, LinkLabel, , Panel, GroupBox, , PictureBox, Splitter, StatusBar, ToolBar, TabPage, ** TabControl | Clique em | Clique em DoubleClick | Clique em | Clique em DoubleClick | Clique em | Clique em DoubleClick | Clique em | Clique em DoubleClick | Clique em | Clique em DoubleClick |
* O ponteiro do mouse deve estar sobre um objeto filho (TreeNode ou ListViewItem).
** O TabControl deve ter pelo menos um TabPage em sua TabPages coleção.