Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Evento Control.Click

 

Publicado: noviembre de 2016

Se produce cuando se hace clic en el control.

Espacio de nombres:   System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

public event EventHandler Click

The E:System.Windows.Forms.Control.Click event passes an T:System.EventArgs to its event handler, so it only indicates that a click has occurred. If you need more specific mouse information (button, number of clicks, wheel rotation, or location), use the E:System.Windows.Forms.Control.MouseClick event. However, the E:System.Windows.Forms.Control.MouseClick event will not be raised if the click is caused by action other than that of the mouse, such as pressing the ENTER key.

A double-click is determined by the mouse settings of the user's operating system. The user can set the time between clicks of a mouse button that should be considered a double-click rather than two clicks. The E:System.Windows.Forms.Control.Click event is raised every time a control is double-clicked. For example, if you have event handlers for the E:System.Windows.Forms.Control.Click and E:System.Windows.Forms.Control.DoubleClick events of a T:System.Windows.Forms.Form, the E:System.Windows.Forms.Control.Click and E:System.Windows.Forms.Control.DoubleClick events are raised when the form is double-clicked and both methods are called. If a control is double-clicked and that control does not support the E:System.Windows.Forms.Control.DoubleClick event, the E:System.Windows.Forms.Control.Click event might be raised twice.

You must set the StandardClick value ofT:System.Windows.Forms.ControlStyles to true for this event to be raised.

System_CAPS_noteNota

The following events are not raised for the T:System.Windows.Forms.TabControl class unless there is at least one T:System.Windows.Forms.TabPage in the P:System.Windows.Forms.TabControl.TabPages collection: E:System.Windows.Forms.Control.Click, E:System.Windows.Forms.Control.DoubleClick, E:System.Windows.Forms.Control.MouseDown, E:System.Windows.Forms.Control.MouseUp, E:System.Windows.Forms.Control.MouseHover, E:System.Windows.Forms.Control.MouseEnter, E:System.Windows.Forms.Control.MouseLeave and E:System.Windows.Forms.Control.MouseMove. If there is at least one T:System.Windows.Forms.TabPage in the collection, and the user interacts with the tab control's header (where the T:System.Windows.Forms.TabPage names appear), the T:System.Windows.Forms.TabControl raises the appropriate event. However, if the user interaction is within the client area of the tab page, the T:System.Windows.Forms.TabPage raises the appropriate event.

For more information about handling events, see Handling and Raising Events.

Notas para desarrolladores de herederos:

Inheriting from a standard Windows Forms control and changing the StandardClick or StandardDoubleClick values of T:System.Windows.Forms.ControlStyles to true can cause unexpected behavior or have no effect at all if the control does not support the E:System.Windows.Forms.Control.Click or E:System.Windows.Forms.Control.DoubleClick events.

The following table lists Windows Forms controls and which event (E:System.Windows.Forms.Control.Click or E:System.Windows.Forms.Control.DoubleClick) is raised in response to the mouse action specified.

Control

Left Mouse Click

Left Mouse Double Click

Right Mouse Click

Right Mouse Double Click

Middle Mouse Click

Middle Mouse Double Click

XButton1 Mouse Click

XButton1 Mouse Double-Click

XButton2 Mouse Click

XButton2 Mouse Double-Click

MonthCalendar,

DateTimePicker,

HScrollBar,

VScrollBar

none

none

none

none

none

none

none

none

none

none

Button,

CheckBox,

RichTextBox,

RadioButton

Click

Click, Click

none

none

none

none

none

none

none

none

ListBox,

CheckedListBox,

ComboBox

Click

Click, DoubleClick

none

none

none

none

none

none

none

none

TextBox,

DomainUpDown,

NumericUpDown

Click

Click, DoubleClick

none

none

none

none

none

none

none

none

* T:System.Windows.Forms.TreeView,

* T:System.Windows.Forms.ListView

Click

Click, DoubleClick

Click

Click, DoubleClick

none

none

none

none

none

none

ProgressBar,

TrackBar

Click

Click, Click

Click

Click, Click

Click

Click, Click

Click

Click, Click

Click

Click, Click

Form,

DataGrid,

Label,

LinkLabel,

Panel,

GroupBox,

PictureBox,

Splitter,

StatusBar,

ToolBar,

TabPage,

** T:System.Windows.Forms.TabControl

Click

Click, DoubleClick

Click

Click, DoubleClick

Click

Click, DoubleClick

Click

Click, DoubleClick

Click

Click, DoubleClick

* The mouse pointer must be over a child object (T:System.Windows.Forms.TreeNode or T:System.Windows.Forms.ListViewItem).

** The T:System.Windows.Forms.TabControl must have at least one T:System.Windows.Forms.TabPage in its P:System.Windows.Forms.TabControl.TabPages collection.

The following code example shows the E:System.Windows.Forms.Control.Click event in an event handler.

// 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;
}

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: