CheckBox.OnClick(EventArgs) Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Raises the Click event.

protected:
 override void OnClick(EventArgs ^ e);

protected override void OnClick (EventArgs e);

override this.OnClick : EventArgs -> unit

Protected Overrides Sub OnClick (e As EventArgs)

Parameters

e

EventArgs

An EventArgs that contains the event data.

Remarks

The OnClick method changes the CheckState property. If the ThreeState property is set to true, subsequent clicks of the CheckBox will result in OnClick cycling through all the values of the CheckState enumeration. Otherwise, OnClick switches between Checked and Unchecked.

Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.

The OnClick method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors

When overriding OnClick(EventArgs) in a derived class, be sure to call the base class' OnClick(EventArgs) method so that registered delegates receive the event.