.NET Windows Forms in a Nutshell

Name

CheckBox

Synopsis

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