GroupBox 类 
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示一个 Windows 控件,该控件显示围绕一组具有可选标题的控件的框架。
public ref class GroupBox : System::Windows::Forms::Controlpublic class GroupBox : System.Windows.Forms.Control[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class GroupBox : System.Windows.Forms.Controltype GroupBox = class
    inherit Control[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type GroupBox = class
    inherit ControlPublic Class GroupBox
Inherits Control- 继承
- 属性
示例
下面的代码示例实例化并创建 一个和两RadioButton个 GroupBox 控件。 单选按钮将添加到组框,并将组框添加到 。Form
private void InitializeMyGroupBox()
{
    // Create and initialize a GroupBox and a Button control.
    GroupBox groupBox1 = new GroupBox();
    Button button1 = new Button();
    button1.Location = new Point(20,10);
    // Set the FlatStyle of the GroupBox.
    groupBox1.FlatStyle = FlatStyle.Flat;
    // Add the Button to the GroupBox.
    groupBox1.Controls.Add(button1);
    // Add the GroupBox to the Form.
    Controls.Add(groupBox1);
    // Create and initialize a GroupBox and a Button control.
    GroupBox groupBox2 = new GroupBox();
    Button button2 = new Button();
    button2.Location = new Point(20, 10);
    groupBox2.Location = new Point(0, 120);
    // Set the FlatStyle of the GroupBox.
    groupBox2.FlatStyle = FlatStyle.Standard;
    // Add the Button to the GroupBox.
    groupBox2.Controls.Add(button2);
    // Add the GroupBox to the Form.
    Controls.Add(groupBox2);
}
Private Sub InitializeMyGroupBox()
   ' Create and initialize a GroupBox and a Button control.
        Dim groupBox1 As New GroupBox()
        Dim button1 As New Button()
        button1.Location = New Point(20, 10)
        ' Set the FlatStyle of the GroupBox.
        groupBox1.FlatStyle = FlatStyle.Flat
        ' Add the Button to the GroupBox.
        groupBox1.Controls.Add(button1)
        ' Add the GroupBox to the Form.
        Controls.Add(groupBox1)
        ' Create and initialize a GroupBox and a Button control.
        Dim groupBox2 As New GroupBox()
        Dim button2 As New Button()
        button2.Location = New Point(20, 10)
        groupBox2.Location = New Point(0, 120)
        ' Set the FlatStyle of the GroupBox.
        groupBox2.FlatStyle = FlatStyle.Standard
        ' Add the Button to the GroupBox.
        groupBox2.Controls.Add(button2)
        ' Add the GroupBox to the Form.
        Controls.Add(groupBox2)
End Sub
注解
在GroupBox带或不带描述文字的一组控件周围显示一个框架。 使用 对 GroupBox 窗体上的控件集合进行逻辑分组。 分组框是可用于定义控件组的容器控件。
分组框的典型用途是包含控件的 RadioButton 逻辑组。 如果有两个组框,每个组包含多个选项按钮 (也称为单选按钮) ,则每组按钮互斥,每个组设置一个选项值。
可以使用 属性的 Controls 方法将控件添加到 。GroupBoxAdd
注意
只能选择控件中包含的 GroupBox 控件或接收焦点。 无法选择完整 GroupBox 本身或接收焦点。 有关此控件如何响应 Focus 和 Select 方法的详细信息,请参阅以下Control成员:CanFocus、、CanSelect、Focused、ContainsFocus、Focus。 Select
无法 GroupBox 显示滚动条。 如果需要类似于 GroupBox 可以包含滚动条的 控件,请参阅 该 Panel 控件。
构造函数
| GroupBox() | 初始化 GroupBox 类的新实例。 | 
属性
| AccessibilityObject | 获取分配给该控件的 AccessibleObject。(继承自 Control) | 
| AccessibleDefaultActionDescription | 获取或设置控件的默认操作说明以供具有辅助功能的客户端应用程序使用。(继承自 Control) | 
| AccessibleDescription | 获取或设置辅助功能客户端应用程序使用的控件说明。(继承自 Control) | 
| AccessibleName | 获取或设置辅助功能客户端应用程序所使用的控件名称。(继承自 Control) | 
| AccessibleRole | 获取或设置控件的辅助性角色。(继承自 Control) | 
| AllowDrop | 获取或设置一个值,该值指示控件是否允许使用拖放操作和事件。 | 
| Anchor | 获取或设置控件绑定到的容器的边缘并确定控件如何随其父级一起调整大小。(继承自 Control) | 
| AutoScrollOffset | 获取或设置一个值,该值指示在 ScrollControlIntoView(Control) 中将控件滚动到何处。(继承自 Control) | 
| AutoSize | 获取或设置一个值,该值指示 GroupBox 是否根据其内容调整大小。 | 
| AutoSize | 此属性与此类无关。(继承自 Control) | 
| AutoSizeMode | |
| BackColor | 获取或设置控件的背景色。(继承自 Control) | 
| 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) | 
| ClientRectangle | 获取表示控件的工作区的矩形。(继承自 Control) | 
| ClientSize | 获取或设置控件的工作区的高度和宽度。(继承自 Control) | 
| 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) 模式。(继承自 Control) | 
| DefaultMargin | 获取控件之间默认指定的间距(以像素为单位)。(继承自 Control) | 
| DefaultMaximumSize | 获取以像素为单位的长度和高度,此长度和高度被指定为控件的默认最大大小。(继承自 Control) | 
| DefaultMinimumSize | 获取以像素为单位的长度和高度,此长度和高度被指定为控件的默认最小大小。(继承自 Control) | 
| DefaultPadding | |
| DefaultPadding | 获取控件内容的默认内部间距(以像素为单位)。(继承自 Control) | 
| DefaultSize | 获取控件的默认大小。 | 
| DesignMode | 获取一个值,用以指示 Component 当前是否处于设计模式。(继承自 Component) | 
| DeviceDpi | 获取显示当前控件的显示设备的 DPI 值。(继承自 Control) | 
| DisplayRectangle | 获取表示 GroupBox 的维度的矩形。 | 
| Disposing | 获取一个值,该值指示 Control 基类是否在释放进程中。(继承自 Control) | 
| Dock | 获取或设置哪些控件边框停靠到其父控件并确定控件如何随其父级一起调整大小。(继承自 Control) | 
| DoubleBuffered | 获取或设置一个值,该值指示此控件是否应使用辅助缓冲区重绘其图面,以减少或避免闪烁。(继承自 Control) | 
| Enabled | 获取或设置一个值,该值指示控件是否可以对用户交互作出响应。(继承自 Control) | 
| Events | 获取附加到此 Component 的事件处理程序的列表。(继承自 Component) | 
| FlatStyle | 获取或设置组框控件的平面样式外观。 | 
| Focused | 获取一个值,该值指示控件是否有输入焦点。(继承自 Control) | 
| Font | 获取或设置控件显示的文字的字体。(继承自 Control) | 
| FontHeight | 获取或设置控件的字体的高度。(继承自 Control) | 
| ForeColor | 获取或设置控件的前景色。(继承自 Control) | 
| Handle | 获取控件绑定到的窗口句柄。(继承自 Control) | 
| HasChildren | 获取一个值,该值指示控件是否包含一个或多个子控件。(继承自 Control) | 
| Height | 获取或设置控件的高度。(继承自 Control) | 
| ImeMode | 获取或设置控件的输入法编辑器 (IME) 模式。(继承自 Control) | 
| ImeModeBase | 获取或设置控件的 IME 模式。(继承自 Control) | 
| InvokeRequired | 获取一个值,该值指示调用方在对控件进行方法调用时是否必须调用 Invoke 方法,因为调用方位于创建控件所在的线程以外的线程中。(继承自 Control) | 
| IsAccessible | 获取或设置一个值,该值指示控件对辅助功能应用程序是否可见。(继承自 Control) | 
| IsAncestorSiteInDesignMode | 指示此控件的上级之一是否位于 DesignMode 中。 此属性为只读。(继承自 Control) | 
| 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 键后是否可以使 GroupBox 获得焦点。 | 
| Tag | 获取或设置包含有关控件的数据的对象。(继承自 Control) | 
| Text | 获取或设置与此控件关联的文本。 | 
| Top | 获取或设置控件上边缘与其容器的工作区上边缘之间的距离(以像素为单位)。(继承自 Control) | 
| TopLevelControl | 获取没有另一个 Windows 窗体控件作为其父级的父控件。 通常,这是控件所在的最外面的 Form。(继承自 Control) | 
| UseCompatibleTextRendering | 获取或设置一个值,该值确定是使用 Graphics 类 (GDI+) 还是 TextRenderer 使用 GDI) 类来呈现文本 (GDI。 | 
| 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) |