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使用 屬性來取得或設定雙狀態控件的值，並使用 CheckState 屬性來取得或設定三狀態CheckBoxCheckBox控件的值。
注意
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 |
取得控制項下邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 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 叫用事件時，將呼叫其 Execute(Object) 方法的 Click 。 (繼承來源 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 |
取得控制項的資料繫結 (Data Binding)。 (繼承來源 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 |
取得或設定值，指出這個控制項是否應使用次要緩衝區重繪其介面，以減少或防止重繪閃動 (Flicker)。 (繼承來源 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 中的索引鍵存取子 (Accessor)。 (繼承來源 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 |
取得或設定控制項左邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 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 |
取得控制項右邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| RightToLeft |
取得或設定值，指出控制項的項目是否對齊，以支援使用由右至左字型的地區設定。 (繼承來源 Control) |
| ScaleChildren |
取得值，以判斷子控制項的縮放。 (繼承來源 Control) |
| ShowFocusCues |
取得指示控制項是否應顯示焦點矩形 (Focus Rectangle) 的值。 (繼承來源 Control) |
| ShowKeyboardCues |
取得值，指出使用者介面是否處於可顯示或隱藏鍵盤快速鍵的適當狀態下。 (繼承來源 Control) |
| Site |
取得或設定控制項的站台。 (繼承來源 Control) |
| Size |
取得或設定控制項的高度和寬度。 (繼承來源 Control) |
| TabIndex |
取得或設定控制項容器中的控制項定位順序。 (繼承來源 Control) |
| TabStop |
取得或設定值，指出使用者是否能使用 TAB 鍵，將焦點 (Focus) 給予這個控制項。 (繼承來源 Control) |
| Tag |
取得或設定物件，其包含控制項相關資料。 (繼承來源 Control) |
| Text |
取得或設定這個控制項的相關文字。 (繼承來源 ButtonBase) |
| TextAlign |
取得或設定 CheckBox 控制項上文字的對齊方式。 |
| TextImageRelation |
取得或設定文字和影像彼此之間的相對位置。 (繼承來源 ButtonBase) |
| ThreeState |
取得或設定值，指出 CheckBox 是否允許三種而非兩種核取狀態。 |
| Top |
取得或設定控制項上邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| TopLevelControl |
取得沒有其他 Windows Form 父控制項的父控制項。 通常，這會是內含控制項最外層的 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) |
