CheckBox

CheckBox

marshal by reference, disposable

---

System. Windows .Forms (system. windows .forms.dll)

class

This Control , derived from ButtonBase , represents a checkable option box. It can represent a two- or ThreeState checkbox. There are two accessors to get the checked state: Checked (a Boolean for a two-state box) and CheckState ( Checked , Unchecked , and Indeterminate for a three-state box). You can handle the CheckedChanged and CheckStateChanged events that are raised when these properties are modified.

In addition, you can specify whether the box should AutoCheck when it is clicked (the alternative being to handle the Click event and set the state yourself), and whether the check should appear to the left or the right of the descriptive text (using the CheckAlign property).

Compare this to RadioButton for the selection of one option from several.

 public class  CheckBox  : ButtonBase {  // Public Constructors  public  CheckBox  ();  // Public Instance Properties  public Appearance  Appearance  {set; get; }    public bool  AutoCheck  {set; get; }    public ContentAlignment  CheckAlign  {set; get; }    public bool  Checked  {set; get; }    public CheckState  CheckState  {set; get; }    public override ContentAlignment  TextAlign  {set; get; }  // overrides ButtonBase  public bool  ThreeState  {set; get; }  // Protected Instance Properties  protected override CreateParams  CreateParams  {get; }  // overrides ButtonBase  protected override Size  DefaultSize  {get; }  // overrides ButtonBase   // Public Instance Methods  public override string  ToString  ();  // overrides System.ComponentModel.Component   // Protected Instance Methods  protected override AccessibleObject  CreateAccessibilityInstance  ();  // overrides ButtonBase  protected virtual void  OnAppearanceChanged  (EventArgs  e  );    protected virtual void  OnCheckedChanged  (EventArgs  e  );    protected virtual void  OnCheckStateChanged  (EventArgs  e  );    protected override void  OnClick  (EventArgs  e  );  // overrides Control  protected override void  OnHandleCreated  (EventArgs  e  );  // overrides Control  protected override void  OnMouseUp  (MouseEventArgs  mevent  );  // overrides ButtonBase  protected override bool  ProcessMnemonic  (char  charCode  );  // overrides Control   // Events  public event EventHandler  AppearanceChanged  ;    public event EventHandler  CheckedChanged  ;    public event EventHandler  CheckStateChanged  ; } 

Hierarchy

System.Object System.MarshalByRefObject System.ComponentModel.Component(System.ComponentModel.IComponen, System.IDisposable) Control(IOleContro, IOleObject , IOleInPlaceObject , IOleInPlaceActiveObject , IOleWindow , IViewObject , IViewObject2 , IPersist , IPersistStreamInit , IPersistPropertyBag , IPersistStorage , IQuickActivate , System.ComponentModel.ISynchronizeInvoke , IWin32Window) ButtonBase CheckBox