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- 繼承
- 屬性
範例
以下程式碼範例實例化並建立了一個 GroupBox 和兩個 RadioButton 控制項。 單選按鈕會加入群組框，群組框則加入 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 顯示一個框架，圍繞著一組控制裝置，有無字幕。 使用 a GroupBox 來邏輯地將表單上的一組控制項分組。 群組框是一個容器控制項，可用來定義控制群組。
群組框的典型用途是包含邏輯控制群組 RadioButton 。 如果你有兩個群組框，每個盒子裡都有多個選項按鈕（也稱為單選按鈕），每組按鈕是互斥的，每個群組設定一個選項值。
你可以用Add屬性的方法Controls在 中GroupBox加入控制項。
備註
只有控制區內 GroupBox 的控制項才能被選擇或獲得焦點。 完整 GroupBox 作品本身無法被選擇或聚焦。 欲了解更多關於此控制如何回應 Focus 和 方法的資訊，請參閱以下Control成員：CanFocus， CanSelect， ContainsFocusFocusedFocusSelect。Select
無法 GroupBox 顯示滾動條。 如果你需要一個類似 a GroupBox 且能包含滾動條的控制項，請參考控制項。Panel
建構函式
| 名稱 | Description |
|---|---|
| GroupBox() |
初始化 GroupBox 類別的新執行個體。 |
屬性
| 名稱 | Description |
|---|---|
| AccessibilityObject |
讓被 AccessibleObject 指派到控制室。 (繼承來源 Control) |
| AccessibleDefaultActionDescription |
取得或設定控制項的預設動作描述，供無障礙客戶端應用程式使用。 (繼承來源 Control) |
| AccessibleDescription |
取得或設定無障礙客戶端應用程式所使用的控制項描述。 (繼承來源 Control) |
| AccessibleName |
取得或設定無障礙客戶端應用程式所使用的控制項名稱。 (繼承來源 Control) |
| AccessibleRole |
取得或設定控制的可及角色。 (繼承來源 Control) |
| AllowDrop |
取得或設定一個值，指示控制項是否允許拖放操作與事件。 |
| Anchor |
取得或設定控制項綁定容器的邊緣，並決定控制項如何與父控制項進行調整大小。 (繼承來源 Control) |
| AutoScrollOffset |
取得或設定，將此控制捲動至。ScrollControlIntoView(Control) (繼承來源 Control) |
| AutoSize |
取得或設定一個值，指示是否根據內容進行 GroupBox 調整。 |
| 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 | |
| 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 |
會獲得一個值，表示呼叫者在呼叫控制項時是否必須呼叫呼叫方法，因為呼叫者使用的執行緒與該控制項建立的執行緒不同。 (繼承來源 Control) |
| IsAccessible |
取得或設定一個值，指示該控制項是否對無障礙應用程式可見。 (繼承來源 Control) |
| IsAncestorSiteInDesignMode |
顯示該控制點的前祖是否被設置在 DesignMode 中。 這個屬性是唯讀的。 (繼承來源 Control) |
| IsDisposed |
會有一個值，表示控制權是否已被處理掉。 (繼承來源 Control) |
| IsHandleCreated |
會得到一個值，表示該控制項是否有與其相關的 handle。 (繼承來源 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 元素是否對齊以支援使用右至左字型的區域。 (繼承來源 Control) |
| ScaleChildren |
會得到一個決定子控制項縮放的值。 (繼承來源 Control) |
| ShowFocusCues |
會得到一個值，指示控制器是否應該顯示焦點矩形。 (繼承來源 Control) |
| ShowKeyboardCues |
會取得一個值，表示使用者介面是否處於顯示或隱藏鍵盤加速器的適當狀態。 (繼承來源 Control) |
| Site |
取得或設定控制點。 (繼承來源 Control) |
| Size |
設定控制器的高度與寬度。 (繼承來源 Control) |
| TabIndex |
取得或設定容器內控制項的制表順序。 (繼承來源 Control) |
| TabStop |
取得或設定一個值，指示使用者是否能按下 TAB 鍵將焦點放在 GroupBox。 |
| Tag |
取得或設定包含控制項資料的物件。 (繼承來源 Control) |
| Text |
取得或設定與此控制項相關的文字。 |
| Top |
取得或設定控制面板頂端與容器用戶端區域頂端之間的距離（以像素為單位）。 (繼承來源 Control) |
| TopLevelControl |
取得沒有被其他 Windows Forms 控制項保護的父控制權。 通常，這是控制所包含的最 Form 外層。 (繼承來源 Control) |
| UseCompatibleTextRendering |
取得或設定一個值，決定是使用 Graphics 類別（GDI+）還是 TextRenderer 類別（GDI）來呈現文字。 |
| UseWaitCursor |
取得或設定一個值，指示是否使用等待游標來控制目前的控制項及所有子控制項。 (繼承來源 Control) |
| Visible |
取得或設定一個值，表示該控制項及其所有子控制項是否被顯示。 (繼承來源 Control) |
| Width |
設定或設定控制寬度。 (繼承來源 Control) |
| WindowTarget |
此性質對此類別無關。 (繼承來源 Control) |
方法
事件
| 名稱 | Description |
|---|---|
| AutoSizeChanged |
發生於 AutoSize 屬性的值變更時。 |
| BackColorChanged |
發生於 BackColor 屬性的值變更時。 (繼承來源 Control) |
| BackgroundImageChanged |
發生於 BackgroundImage 屬性的值變更時。 (繼承來源 Control) |
| BackgroundImageLayoutChanged |
當房產變更時 BackgroundImageLayout 發生。 (繼承來源 Control) |
| BindingContextChanged |
發生於 BindingContext 屬性的值變更時。 (繼承來源 Control) |
| CausesValidationChanged |
發生於 CausesValidation 屬性的值變更時。 (繼承來源 Control) |
| ChangeUICues |
當焦點或鍵盤使用者介面（UI）提示改變時，會發生這種情況。 (繼承來源 Control) |
| Click |
當使用者點擊 GroupBox 控制鍵時會發生。 |
| ClientSizeChanged |
發生於 ClientSize 屬性的值變更時。 (繼承來源 Control) |
| ContextMenuChanged |
已淘汰.
發生於 ContextMenu 屬性的值變更時。 (繼承來源 Control) |
| ContextMenuStripChanged |
發生於 ContextMenuStrip 屬性的值變更時。 (繼承來源 Control) |
| ControlAdded |
當新增控制項加入 Control.ControlCollection時，會發生。 (繼承來源 Control) |
| ControlRemoved |
當控制項從 中移除 Control.ControlCollection時發生。 (繼承來源 Control) |
| CursorChanged |
發生於 Cursor 屬性的值變更時。 (繼承來源 Control) |
| DataContextChanged |
發生於 DataContext 屬性的值變更時。 (繼承來源 Control) |
| Disposed |
當元件被呼叫方法 Dispose() 時會發生。 (繼承來源 Component) |
| DockChanged |
發生於 Dock 屬性的值變更時。 (繼承來源 Control) |
| DoubleClick |
當使用者雙擊 GroupBox 控制鍵時會發生。 |
| DpiChangedAfterParent |
當控制器的 DPI 設定在父控制器或表單的 DPI 改變後，程式方式更改時會發生。 (繼承來源 Control) |
| DpiChangedBeforeParent |
當控制器的 DPI 設定在父控制器或表單的 DPI 變更事件尚未發生之前，程式化地更改時就會發生。 (繼承來源 Control) |
| DragDrop |
當拖放操作完成時會發生。 (繼承來源 Control) |
| DragEnter |
當物體被拖入控制範圍時，會發生這種情況。 (繼承來源 Control) |
| DragLeave |
當物體被拖出控制範圍時，會發生這種情況。 (繼承來源 Control) |
| DragOver |
當物體被拖過控制範圍時會發生。 (繼承來源 Control) |
| EnabledChanged |
發生於 Enabled 屬性值變更時。 (繼承來源 Control) |
| Enter |
當進入控制區時發生。 (繼承來源 Control) |
| FontChanged |
當房產價值變動時 Font 發生。 (繼承來源 Control) |
| ForeColorChanged |
當房產價值變動時 ForeColor 發生。 (繼承來源 Control) |
| GiveFeedback |
發生在拖曳操作期間。 (繼承來源 Control) |
| GotFocus |
當控制裝置被聚焦時發生。 (繼承來源 Control) |
| HandleCreated |
當控制器被建立把柄時，會發生這種情況。 (繼承來源 Control) |
| HandleDestroyed |
當控制器的把手正在被摧毀時，會發生這種情況。 (繼承來源 Control) |
| HelpRequested |
當使用者請求控制權協助時會發生。 (繼承來源 Control) |
| ImeModeChanged |
當房產發生變化時 ImeMode 。 (繼承來源 Control) |
| Invalidated |
當控制器顯示需要重新繪製時，會發生這種情況。 (繼承來源 Control) |
| KeyDown |
當使用者在控制器保持對焦狀態時按下按鍵 GroupBox 時會發生。 |
| KeyPress |
當使用者在控制器保持對焦狀態時按下按鍵 GroupBox 時會發生。 |
| KeyUp |
當使用者在控制器保持對焦時放開按鍵 GroupBox 時會發生。 |
| Layout |
當控制項應該重新定位其子控制項時，會發生這種情況。 (繼承來源 Control) |
| Leave |
當輸入焦點離開控制器時會發生。 (繼承來源 Control) |
| LocationChanged |
發生於 Location 屬性值變更時。 (繼承來源 Control) |
| LostFocus |
當控制失焦時會發生。 (繼承來源 Control) |
| MarginChanged |
當對照組的邊界改變時會發生。 (繼承來源 Control) |
| MouseCaptureChanged |
當控制組失去滑鼠捕捉時會發生。 (繼承來源 Control) |
| MouseClick |
當使用者用滑鼠點擊 GroupBox 控制鍵時會發生。 |
| MouseDoubleClick |
當使用者用滑鼠雙擊 GroupBox 控制鍵時會發生。 |
| MouseDown |
當使用者按下滑鼠按鈕時，滑鼠指標正放在控制器上方。 |
| MouseEnter |
當滑鼠指標進入控制鍵時會發生。 |
| MouseHover |
當滑鼠指標放在控制器上時會發生。 (繼承來源 Control) |
| MouseLeave |
當滑鼠指標離開控制鍵時會發生。 |
| MouseMove |
當使用者將滑鼠指標移到控制器上時會發生。 |
| MouseUp |
當使用者放開滑鼠按鈕時，滑鼠指標正放在控制器上方。 |
| MouseWheel |
當滑鼠滾輪移動時，控制器仍保持對焦。 (繼承來源 Control) |
| Move |
當控制桿移動時會發生。 (繼承來源 Control) |
| PaddingChanged |
當控制器的填充物改變時會發生。 (繼承來源 Control) |
| Paint |
當控制鍵重新繪製時會發生。 (繼承來源 Control) |
| ParentChanged |
當房產價值變動時 Parent 發生。 (繼承來源 Control) |
| PreviewKeyDown |
當按鍵在該控制鍵上時，會發生在事件發生 KeyDown 前。 (繼承來源 Control) |
| QueryAccessibilityHelp |
當 AccessibleObject 提供無障礙應用程式協助時，會發生這種情況。 (繼承來源 Control) |
| QueryContinueDrag |
發生在拖放操作期間，使拖曳源判斷是否應該取消拖放操作。 (繼承來源 Control) |
| RegionChanged |
發生於 Region 屬性的值變更時。 (繼承來源 Control) |
| Resize |
當控制大小被調整時會發生。 (繼承來源 Control) |
| RightToLeftChanged |
當房產價值變動時 RightToLeft 發生。 (繼承來源 Control) |
| SizeChanged |
當房產價值變動時 Size 發生。 (繼承來源 Control) |
| StyleChanged |
當控制風格改變時會發生。 (繼承來源 Control) |
| SystemColorsChanged |
當系統顏色改變時會發生。 (繼承來源 Control) |
| TabIndexChanged |
當房產價值變動時 TabIndex 發生。 (繼承來源 Control) |
| TabStopChanged |
發生於 TabStop 屬性的值變更時。 |
| TextChanged |
當房產價值變動時 Text 發生。 (繼承來源 Control) |
| Validated |
當控制驗證完成時發生。 (繼承來源 Control) |
| Validating |
當對照組進行驗證時會發生。 (繼承來源 Control) |
| VisibleChanged |
當房產價值變動時 Visible 發生。 (繼承來源 Control) |
明確介面實作
| 名稱 | Description |
|---|---|
| IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |
