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- 继承
- 属性
示例
下面的代码示例创建并初始化 CheckBox，为它提供切换按钮的外观，将 设置为 AutoCheckfalse，并将其添加到 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
注解
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 |
获取或设置一个值，该值指示当单击某一 Checked 时，CheckState 或 CheckBox 的值以及该 CheckBox 的外观是否自动改变。 |
| AutoEllipsis |
获取或设置一个值，该值指示是否要在控件的右边缘显示省略号 (...) 以表示控件文本超出指定的控件长度。 (继承自 ButtonBase) |
| AutoScrollOffset |
获取或设置一个值，该值指示在 ScrollControlIntoView(Control) 中将控件滚动到何处。 (继承自 Control) |
| AutoSize |
获取或设置一个值，该值指示控件是否基于其内容调整大小。 (继承自 ButtonBase) |
| BackColor |
获取或设置控件的背景色。 (继承自 ButtonBase) |
| BackgroundImage |
获取或设置在控件中显示的背景图像。 (继承自 Control) |
| BackgroundImageLayout |
获取或设置在 ImageLayout 枚举中定义的背景图像布局。 (继承自 Control) |
| BindingContext |
获取或设置控件的 BindingContext。 (继承自 Control) |
| Bottom |
获取控件下边缘与其容器的工作区上边缘之间的距离（以像素为单位）。 (继承自 Control) |
| Bounds |
获取或设置控件（包括其非工作区元素）相对于其父控件的大小和位置（以像素为单位）。 (继承自 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 |
获取一个值，该值指示调用方在对控件进行方法调用时是否必须调用 Invoke 方法，因为调用方位于创建控件所在的线程以外的线程中。 (继承自 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) 类来呈现文本 (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) |
