CheckBox 类

项目
08/17/2007

表示 Windows CheckBox。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class CheckBox
    Inherits ButtonBase
用法
Dim instance As CheckBox

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
public class CheckBox : ButtonBase

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
public ref class CheckBox : public ButtonBase

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class CheckBox extends ButtonBase

ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class CheckBox extends ButtonBase

备注

使用 CheckBox 可为用户提供一项选择，如“真/假”或“是/否”。该 CheckBox 控件可以显示一个图像或文本，或两者都显示。

CheckBox 和 RadioButton 控件拥有一个相似的功能：允许用户从选项列表中进行选择。CheckBox 控件允许用户选择一组选项。与之相反，RadioButton 控件允许用户从互相排斥的选项中进行选择。

Appearance 属性确定 CheckBox 显示为常见的 CheckBox 还是显示为按钮。

ThreeState 属性确定该控件是支持两种状态还是三种状态。使用 Checked 属性可以获取或设置具有两种状态的 CheckBox 控件的值，而使用 CheckState 属性可以获取或设置具有三种状态的 CheckBox 控件的值。

提示

如果将 ThreeState 属性设置为 true，则 Checked 属性将为已选中或不确定状态返回 true。

FlatStyle 属性确定控件的样式和外观。如果 FlatStyle 属性设置为 FlatStyle.System，则控件的外观由用户的操作系统确定。

提示

当 FlatStyle 属性设置为 FlatStyle.System 时，将忽略 CheckAlign 属性，并将使用 ContentAlignment.MiddleLeft 或 ContentAlignment.MiddleRight 对齐方式显示控件。如果 CheckAlign 属性设置为右对齐方式之一，则会使用 ContentAlignment.MiddleRight 对齐方式显示控件；否则使用 ContentAlignment.MiddleLeft 对齐方式显示控件。

下面描述一种不确定状态：有一个用于确定 RichTextBox 中选定的文本是否为粗体的 CheckBox。选择文本时，您可以单击 CheckBox 以将选定文本变成粗体。同样，选择一些文本时，CheckBox 将显示选定的文本是否为粗体。如果选定的文本包含粗体和常规文本，则 CheckBox 将处于不确定状态。

示例

下面的代码示例创建了一个 CheckBox 并对它进行了初始化，为它赋予切换按钮的外观，将 AutoCheck 设置为 false，并将该复选框添加到 Form 中。

Public Sub InstantiateMyCheckBox()
    ' Create and initialize a CheckBox.   
    Dim checkBox1 As New CheckBox()
    
    ' Make the check box control appear as a toggle button.
    checkBox1.Appearance = Appearance.Button
    
    ' Turn off the update of the display on the click of the control.
    checkBox1.AutoCheck = False
    
    ' Add the check box control to the form.
    Controls.Add(checkBox1)
End Sub 'InstantiateMyCheckBox

public void InstantiateMyCheckBox()
 {
    // Create and initialize a CheckBox.   
    CheckBox checkBox1 = new CheckBox(); 
    
    // Make the check box control appear as a toggle button.
    checkBox1.Appearance = Appearance.Button;
 
    // Turn off the update of the display on the click of the control.
    checkBox1.AutoCheck = false;
 
    // Add the check box control to the form.
    Controls.Add(checkBox1);
 }

public:
   void InstantiateMyCheckBox()
   {
      // Create and initialize a CheckBox.   
      CheckBox^ checkBox1 = gcnew CheckBox;
      
      // Make the check box control appear as a toggle button.
      checkBox1->Appearance = Appearance::Button;
      
      // Turn off the update of the display on the click of the control.
      checkBox1->AutoCheck = false;
      
      // Add the check box control to the form.
      this->Controls->Add( checkBox1 );
   }

public void InstantiateMyCheckBox()
{
    // Create and initialize a CheckBox.   
    CheckBox checkBox1 = new CheckBox();

    // Make the check box control appear as a toggle button.
    checkBox1.set_Appearance(Appearance.Button);

    // Turn off the update of the display on the click of the control.
    checkBox1.set_AutoCheck(false);

    // Add the check box control to the form.
    get_Controls().Add(checkBox1);
} //InstantiateMyCheckBox

public function InstantiateMyCheckBox()
 {
    // Create and initialize a CheckBox.   
    var checkBox1 : CheckBox = new CheckBox(); 
    
    // Make the check box control appear as a toggle button.
    checkBox1.Appearance = Appearance.Button;
 
    // Turn off the update of the display on the click of the control.
    checkBox1.AutoCheck = false;
 
    // Add the check box control to the form.
    Controls.Add(checkBox1);
 }

继承层次结构

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
         System.Windows.Forms.ButtonBase
          System.Windows.Forms.CheckBox

线程安全

此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

通过

CheckBox 类

语法

备注

示例

继承层次结构

线程安全

平台

版本信息

.NET Framework

.NET Compact Framework

请参见

参考

其他资源

其他资源