CheckBox 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示 Windows CheckBox。
public ref class CheckBox : System::Windows::Forms::ButtonBasepublic class CheckBox : System.Windows.Forms.ButtonBase[System.ComponentModel.DefaultBindingProperty("CheckState")]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class CheckBox : System.Windows.Forms.ButtonBase[System.ComponentModel.DefaultBindingProperty("CheckState")]
public class CheckBox : System.Windows.Forms.ButtonBasetype CheckBox = class
inherit ButtonBase[<System.ComponentModel.DefaultBindingProperty("CheckState")>]
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CheckBox = class
inherit ButtonBase[<System.ComponentModel.DefaultBindingProperty("CheckState")>]
type CheckBox = class
inherit ButtonBasePublic Class CheckBox
Inherits ButtonBase- 继承
- 属性
示例
下面的代码示例创建并初始化 a CheckBox，使其外观切换按钮、设置为 AutoCheckfalse 并将其添加到 a Form。
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.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 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
注解
使用 a CheckBox 为用户提供一个选项，例如 true/false 或 yes/no。 控件 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.MiddleRight对齐方式显示ContentAlignment.MiddleLeft控件。 如果属性 CheckAlign 设置为右对齐方式之一，则控件使用 ContentAlignment.MiddleRight 对齐方式显示;否则，该控件使用 ContentAlignment.MiddleLeft 对齐方式显示。
下面描述了不确定的状态：你有一个 CheckBox 确定所选文本是否 RichTextBox 为粗体。 选择文本时，可以单击 CheckBox 以粗体显示所选内容。 同样，选择某些文本时，将显示 CheckBox 所选文本是否为粗体。 如果所选文本包含粗体和正常文本，则 CheckBox 状态将不确定。
构造函数
| 名称 | 说明 |
|---|---|
| CheckBox() |
初始化 CheckBox 类的新实例。 |
属性
| 名称 | 说明 |
|---|---|
| AccessibilityObject |
AccessibleObject获取分配给控件的控件。 (继承自 Control) |
| AccessibleDefaultActionDescription |
获取或设置控件的默认操作说明，以供辅助功能客户端应用程序使用。 (继承自 Control) |
| AccessibleDescription |
获取或设置辅助功能客户端应用程序使用的控件的说明。 (继承自 Control) |
| AccessibleName |
获取或设置辅助功能客户端应用程序使用的控件的名称。 (继承自 Control) |
| AccessibleRole |
获取或设置控件的可访问角色。 (继承自 Control) |
| AllowDrop |
获取或设置一个值，该值指示控件是否可以接受用户拖动到其中的数据。 (继承自 Control) |
| Anchor |
获取或设置控件绑定到的容器的边缘，并确定控件的父级如何调整其大小。 (继承自 Control) |
| Appearance |
获取或设置确定控件外观 CheckBox 的值。 |
| AutoCheck |
获取或设置一个值，该值指示单击时CheckBox是否Checked自动更改或CheckState值和CheckBox外观。 |
| AutoEllipsis |
获取或设置一个值，该值指示省略号字符 （...） 是否出现在控件的右边缘，表示控件文本超出控件的指定长度。 (继承自 ButtonBase) |
| AutoScrollOffset |
获取或设置此控件滚动到的位置 ScrollControlIntoView(Control)。 (继承自 Control) |
| AutoSize |
获取或设置一个值，该值指示控件是否根据其内容调整大小。 (继承自 ButtonBase) |
| BackColor |
获取或设置控件的背景色。 (继承自 ButtonBase) |
| BackgroundImage |
获取或设置控件中显示的背景图像。 (继承自 Control) |
| BackgroundImageLayout |
获取或设置枚举中 ImageLayout 定义的背景图像布局。 (继承自 Control) |
| BindingContext |
获取或设置 BindingContext 控件。 (继承自 Control) |
| Bottom |
获取控件的下边缘与其容器工作区的上边缘之间的距离（以像素为单位）。 (继承自 Control) |
| Bounds |
获取或设置控件的大小和位置，包括其相对于父控件的非client 元素（以像素为单位）。 (继承自 Control) |
| CanEnableIme |
获取一个值，该值指示属性是否可以 ImeMode 设置为活动值，以启用 IME 支持。 (继承自 Control) |
| CanFocus |
获取一个值，该值指示控件是否可以接收焦点。 (继承自 Control) |
| CanRaiseEvents |
确定是否可以在控件上引发事件。 (继承自 Control) |
| CanSelect |
获取一个值，该值指示是否可以选择控件。 (继承自 Control) |
| Capture |
获取或设置一个值，该值指示控件是否已捕获鼠标。 (继承自 Control) |
| CausesValidation |
获取或设置一个值，该值指示控件是否导致验证在收到焦点时需要验证的任何控件上执行。 (继承自 Control) |
| CheckAlign |
获取或设置控件上 CheckBox 复选标记的水平和垂直对齐方式。 |
| Checked |
获取或设置一个值，该值 CheckBox 指示是否处于选中状态。 |
| CheckState |
获取或设置 CheckBox. |
| ClientRectangle |
获取表示控件工作区的矩形。 (继承自 Control) |
| ClientSize |
获取或设置控件工作区的高度和宽度。 (继承自 Control) |
| Command |
获取或设置ICommand调用事件时Click将调用其Execute(Object)方法。 (继承自 ButtonBase) |
| CommandParameter |
获取或设置传递给 ICommand 分配给属性的参数 Command 。 (继承自 ButtonBase) |
| CompanyName |
获取包含控件的应用程序的公司或创建者的名称。 (继承自 Control) |
| Container |
IContainer获取包含 .Component (继承自 Component) |
| ContainsFocus |
获取一个值，该值指示控件或其子控件之一当前是否具有输入焦点。 (继承自 Control) |
| ContextMenu |
已过时.
获取或设置与控件关联的快捷菜单。 (继承自 Control) |
| ContextMenuStrip |
获取或设置 ContextMenuStrip 与此控件关联的值。 (继承自 Control) |
| Controls |
获取控件中包含的控件的集合。 (继承自 Control) |
| Created |
获取一个值，该值指示是否已创建控件。 (继承自 Control) |
| CreateParams |
获取创建控件句柄时所需的创建参数。 |
| Cursor |
获取或设置鼠标指针位于控件上时显示的光标。 (继承自 Control) |
| DataBindings |
获取控件的数据绑定。 (继承自 Control) |
| DataContext |
获取或设置用于数据绑定的数据上下文。 这是一个环境属性。 (继承自 Control) |
| DefaultCursor |
获取或设置控件的默认游标。 (继承自 Control) |
| DefaultImeMode |
获取此控件支持的默认输入法编辑器 （IME） 模式。 (继承自 ButtonBase) |
| DefaultMargin |
获取默认情况下在控件之间指定的空间（以像素为单位）。 (继承自 Control) |
| DefaultMaximumSize |
获取指定为控件的默认最大大小的长度和高度（以像素为单位）。 (继承自 Control) |
| DefaultMinimumSize |
获取指定为控件的默认最小大小的长度和高度（以像素为单位）。 (继承自 Control) |
| DefaultPadding |
获取控件内容的默认内部间距（以像素为单位）。 (继承自 Control) |
| DefaultSize |
获取控件的默认大小。 |
| DesignMode |
获取一个值，该值指示当前是否 Component 处于设计模式。 (继承自 Component) |
| DeviceDpi |
获取当前显示控件的显示设备的 DPI 值。 (继承自 Control) |
| DisplayRectangle |
获取表示控件的显示区域的矩形。 (继承自 Control) |
| Disposing |
获取一个值，该值指示基 Control 类是否正在处理。 (继承自 Control) |
| Dock |
获取或设置哪些控件边框停靠到其父控件，并确定控件如何调整其父级的大小。 (继承自 Control) |
| DoubleBuffered |
获取或设置一个值，该值指示此控件是否应使用辅助缓冲区重新绘制其表面以减少或防止闪烁。 (继承自 Control) |
| Enabled |
获取或设置一个值，该值指示控件是否可以响应用户交互。 (继承自 Control) |
| Events |
获取附加到此 Component对象的事件处理程序的列表。 (继承自 Component) |
| FlatAppearance |
获取边框的外观以及用于指示检查状态和鼠标状态的颜色。 (继承自 ButtonBase) |
| FlatStyle |
获取或设置按钮控件的平面样式外观。 (继承自 ButtonBase) |
| Focused |
获取一个值，该值指示控件是否具有输入焦点。 (继承自 Control) |
| Font |
获取或设置控件显示的文本的字体。 (继承自 Control) |
| FontHeight |
获取或设置控件字体的高度。 (继承自 Control) |
| ForeColor |
获取或设置控件的前景色。 (继承自 Control) |
| Handle |
获取控件绑定到的窗口句柄。 (继承自 Control) |
| HasChildren |
获取一个值，该值指示控件是否包含一个或多个子控件。 (继承自 Control) |
| Height |
获取或设置控件的高度。 (继承自 Control) |
| Image |
获取或设置按钮控件上显示的图像。 (继承自 ButtonBase) |
| ImageAlign |
获取或设置按钮控件上图像的对齐方式。 (继承自 ButtonBase) |
| ImageIndex |
获取或设置按钮控件上显示的图像的图像列表索引值。 (继承自 ButtonBase) |
| ImageKey |
获取或设置图像的 ImageList键访问器。 (继承自 ButtonBase) |
| ImageList |
获取或设置 ImageList 包含 Image 按钮控件上显示的内容。 (继承自 ButtonBase) |
| ImeMode |
获取或设置此控件支持的输入法编辑器 （IME） 模式。 此属性与此类无关。 (继承自 ButtonBase) |
| ImeModeBase |
获取或设置控件的 IME 模式。 (继承自 Control) |
| InvokeRequired |
获取一个值，该值指示调用方在对控件进行方法调用时是否必须调用调用方法，因为调用方与创建控件的线程不同。 (继承自 Control) |
| IsAccessible |
获取或设置一个值，该值指示控件是否对辅助功能应用程序可见。 (继承自 Control) |
| IsAncestorSiteInDesignMode |
指示此控件的上级位置之一是否位于 DesignMode 中。 此属性为只读。 (继承自 Control) |
| IsDefault |
获取或设置一个值，该值指示按钮控件是否为默认按钮。 (继承自 ButtonBase) |
| IsDisposed |
获取一个值，该值指示控件是否已释放。 (继承自 Control) |
| IsHandleCreated |
获取一个值，该值指示控件是否具有与之关联的句柄。 (继承自 Control) |
| IsMirrored |
获取一个值，该值指示控件是否镜像。 (继承自 Control) |
| LayoutEngine |
获取控件布局引擎的缓存实例。 (继承自 Control) |
| Left |
获取或设置控件左边缘与其容器工作区的左边缘之间的距离（以像素为单位）。 (继承自 Control) |
| Location |
获取或设置控件左上角相对于其容器左上角的坐标。 (继承自 Control) |
| Margin |
获取或设置控件之间的间距。 (继承自 Control) |
| MaximumSize |
获取或设置可指定上限 GetPreferredSize(Size) 的大小。 (继承自 Control) |
| MinimumSize |
获取或设置可以指定的下限 GetPreferredSize(Size) 的大小。 (继承自 Control) |
| Name |
获取或设置控件的名称。 (继承自 Control) |
| Padding |
获取或设置控件中的填充。 (继承自 Control) |
| Parent |
获取或设置控件的父容器。 (继承自 Control) |
| PreferredSize |
获取控件可以容纳到的矩形区域的大小。 (继承自 Control) |
| ProductName |
获取包含控件的程序集的产品名称。 (继承自 Control) |
| ProductVersion |
获取包含控件的程序集的版本。 (继承自 Control) |
| RecreatingHandle |
获取一个值，该值指示控件当前是否正在重新创建其句柄。 (继承自 Control) |
| Region |
获取或设置与控件关联的窗口区域。 (继承自 Control) |
| RenderRightToLeft |
已过时.
已过时.
此属性现已过时。 (继承自 Control) |
| ResizeRedraw |
获取或设置一个值，该值指示控件在调整大小时是否重新绘制自身。 (继承自 Control) |
| Right |
获取控件右边缘与其容器工作区的左边缘之间的距离（以像素为单位）。 (继承自 Control) |
| RightToLeft |
获取或设置一个值，该值指示控件的元素是否对齐以支持使用从右到左字体的区域设置。 (继承自 Control) |
| ScaleChildren |
获取一个值，该值确定子控件的缩放。 (继承自 Control) |
| ShowFocusCues |
获取一个值，该值指示控件是否应显示焦点矩形。 (继承自 Control) |
| ShowKeyboardCues |
获取一个值，该值指示用户界面是否处于适当的状态以显示或隐藏键盘加速器。 (继承自 Control) |
| Site |
获取或设置控件的站点。 (继承自 Control) |
| Size |
获取或设置控件的高度和宽度。 (继承自 Control) |
| TabIndex |
获取或设置控件在其容器中的 Tab 键顺序。 (继承自 Control) |
| TabStop |
获取或设置一个值，该值指示用户是否可以使用 TAB 键向此控件提供焦点。 (继承自 Control) |
| Tag |
获取或设置包含有关控件的数据的对象。 (继承自 Control) |
| Text |
获取或设置与此控件关联的文本。 (继承自 ButtonBase) |
| TextAlign |
获取或设置控件上文本的 CheckBox 对齐方式。 |
| TextImageRelation |
获取或设置文本和图像相对于彼此的位置。 (继承自 ButtonBase) |
| ThreeState |
获取或设置一个值，该值 CheckBox 指示是否允许三个检查状态，而不是两个。 |
| Top |
获取或设置控件上边缘与其容器工作区上边缘之间的距离（以像素为单位）。 (继承自 Control) |
| TopLevelControl |
获取其他 Windows 窗体控件未父控件的父控件。 通常，这是控件包含在的最外层 Form 。 (继承自 Control) |
| UseCompatibleTextRendering |
获取或设置一个值，该值确定是否使用 Graphics 类（GDI+）或 TextRenderer 类（GDI）来呈现文本。 (继承自 ButtonBase) |
| UseMnemonic |
获取或设置一个值，该值指示第一个字符前面是否使用安和（&）作为控件的助记键。 (继承自 ButtonBase) |
| UseVisualStyleBackColor |
获取或设置一个值，该值确定是否使用视觉样式绘制背景（如果受支持）。 (继承自 ButtonBase) |
| UseWaitCursor |
获取或设置一个值，该值指示是否对当前控件和所有子控件使用等待游标。 (继承自 Control) |
| Visible |
获取或设置一个值，该值指示是否显示控件及其所有子控件。 (继承自 Control) |
| Width |
获取或设置控件的宽度。 (继承自 Control) |
| WindowTarget |
此属性与此类无关。 (继承自 Control) |
方法
活动
显式接口实现
| 名称 | 说明 |
|---|---|
| IDropTarget.OnDragDrop(DragEventArgs) |
引发 DragDrop 事件。 (继承自 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引发 DragEnter 事件。 (继承自 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引发 DragLeave 事件。 (继承自 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引发 DragOver 事件。 (继承自 Control) |
