RadioButton 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
允許使用者從一組選項中選取單一選項，與其他 RadioButton 控制項搭配。
public ref class RadioButton : System::Windows::Forms::ButtonBasepublic class RadioButton : System.Windows.Forms.ButtonBase[System.ComponentModel.DefaultBindingProperty("Checked")]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class RadioButton : System.Windows.Forms.ButtonBase[System.ComponentModel.DefaultBindingProperty("Checked")]
public class RadioButton : System.Windows.Forms.ButtonBasetype RadioButton = class
inherit ButtonBase[<System.ComponentModel.DefaultBindingProperty("Checked")>]
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type RadioButton = class
inherit ButtonBase[<System.ComponentModel.DefaultBindingProperty("Checked")>]
type RadioButton = class
inherit ButtonBasePublic Class RadioButton
Inherits ButtonBase- 繼承
- 屬性
範例
下列程式代碼範例會在 中建立和初始化兩 RadioButton 個 GroupBox控件。 此範例會CheckedChanged使用 事件來追蹤選取的專案RadioButton，並在使用者按兩下Button時報告所選取RadioButton的文字。 若要執行此範例，請將程式代碼貼到 Windows Form 中。 從表單的建構函式或Load事件處理方法呼叫InitializeRadioButtons。
private GroupBox groupBox1;
private RadioButton radioButton2;
private RadioButton radioButton1;
private RadioButton selectedrb;
private Button getSelectedRB;
public void InitializeRadioButtons()
{
this.groupBox1 = new System.Windows.Forms.GroupBox();
this.radioButton2 = new System.Windows.Forms.RadioButton();
this.radioButton1 = new System.Windows.Forms.RadioButton();
this.getSelectedRB = new System.Windows.Forms.Button();
this.groupBox1.Controls.Add(this.radioButton2);
this.groupBox1.Controls.Add(this.radioButton1);
this.groupBox1.Controls.Add(this.getSelectedRB);
this.groupBox1.Location = new System.Drawing.Point(30, 100);
this.groupBox1.Size = new System.Drawing.Size(220, 125);
this.groupBox1.Text = "Radio Buttons";
this.radioButton2.Location = new System.Drawing.Point(31, 53);
this.radioButton2.Size = new System.Drawing.Size(67, 17);
this.radioButton2.Text = "Choice 2";
this.radioButton2.CheckedChanged += new EventHandler(radioButton_CheckedChanged);
this.radioButton1.Location = new System.Drawing.Point(31, 20);
this.radioButton1.Name = "radioButton1";
this.radioButton1.Size = new System.Drawing.Size(67, 17);
this.radioButton1.Text = "Choice 1";
this.radioButton1.CheckedChanged += new EventHandler(radioButton_CheckedChanged);
this.getSelectedRB.Location = new System.Drawing.Point(10, 75);
this.getSelectedRB.Size = new System.Drawing.Size(200, 25);
this.getSelectedRB.Text = "Get selected RadioButton";
this.getSelectedRB.Click += new EventHandler(getSelectedRB_Click);
this.ClientSize = new System.Drawing.Size(292, 266);
this.Controls.Add(this.groupBox1);
}
void radioButton_CheckedChanged(object sender, EventArgs e)
{
RadioButton rb = sender as RadioButton;
if (rb == null)
{
MessageBox.Show("Sender is not a RadioButton");
return;
}
// Ensure that the RadioButton.Checked property
// changed to true.
if (rb.Checked)
{
// Keep track of the selected RadioButton by saving a reference
// to it.
selectedrb = rb;
}
}
// Show the text of the selected RadioButton.
void getSelectedRB_Click(object sender, EventArgs e)
{
MessageBox.Show(selectedrb.Text);
}
Private groupBox1 As GroupBox
Private radioButton2 As RadioButton
Private radioButton1 As RadioButton
Private selectedrb As RadioButton
Private WithEvents getSelectedRB As Button
Public Sub InitializeRadioButtons()
Me.groupBox1 = New System.Windows.Forms.GroupBox()
Me.radioButton2 = New System.Windows.Forms.RadioButton()
Me.radioButton1 = New System.Windows.Forms.RadioButton()
Me.getSelectedRB = New System.Windows.Forms.Button()
Me.groupBox1.Controls.Add(Me.radioButton2)
Me.groupBox1.Controls.Add(Me.radioButton1)
Me.groupBox1.Controls.Add(Me.getSelectedRB)
Me.groupBox1.Location = New System.Drawing.Point(30, 100)
Me.groupBox1.Size = New System.Drawing.Size(220, 125)
Me.groupBox1.Text = "Radio Buttons"
Me.radioButton2.Location = New System.Drawing.Point(31, 53)
Me.radioButton2.Size = New System.Drawing.Size(67, 17)
Me.radioButton2.Text = "Choice 2"
AddHandler Me.radioButton2.Click, AddressOf radioButton_CheckedChanged
Me.radioButton1.Location = New System.Drawing.Point(31, 20)
Me.radioButton1.Name = "radioButton1"
Me.radioButton1.Size = New System.Drawing.Size(67, 17)
Me.radioButton1.Text = "Choice 1"
AddHandler Me.radioButton1.Click, AddressOf radioButton_CheckedChanged
Me.getSelectedRB.Location = New System.Drawing.Point(10, 75)
Me.getSelectedRB.Size = New System.Drawing.Size(200, 25)
Me.getSelectedRB.Text = "Get selected RadioButton"
Me.ClientSize = New System.Drawing.Size(292, 266)
Me.Controls.Add(Me.groupBox1)
End Sub
Private Sub radioButton_CheckedChanged(ByVal sender As Object, ByVal e As EventArgs) _
Dim rb As RadioButton = TryCast(sender, RadioButton)
If rb Is Nothing Then
MessageBox.Show("Sender is not a RadioButton")
Return
End If
' Ensure that the RadioButton.Checked property
' changed to true.
If rb.Checked Then
' Keep track of the selected RadioButton by saving a reference
' to it.
selectedrb = rb
End If
End Sub
' Show the text of the selected RadioButton.
Private Sub getSelectedRB_Click(ByVal sender As Object, ByVal e As EventArgs) _
Handles getSelectedRB.Click
MessageBox.Show(selectedrb.Text)
End Sub
備註
控件 RadioButton 可以顯示文字、 Image、 或兩者。
當使用者選取單選按鈕 (也稱為群組內的單選按鈕) 時，其他人會自動清除。 RadioButton指定容器中的所有控件，例如 Form，都會構成群組。 若要在一個表單上建立多個群組，請將每個群組放在自己的容器中，例如 GroupBox 或 Panel 控件。
RadioButton 和 CheckBox 控制項具有類似的功能：他們提供使用者可以選取或清除的選項。 差異在於可以同時選取多個 CheckBox 控件，但選項按鈕互斥。
Checked使用屬性取得或設定 的狀態RadioButton。 選項按鈕的外觀可以藉由設定 Appearance 屬性來改變為切換樣式按鈕或標準選項按鈕。
建構函式
| RadioButton() |
初始化 RadioButton 類別的新執行個體。 |
屬性
| AccessibilityObject |
取得指定給控制項的 AccessibleObject。 (繼承來源 Control) |
| AccessibleDefaultActionDescription |
取得或設定協助用戶端應用程式所使用的控制項的預設動作描述。 (繼承來源 Control) |
| AccessibleDescription |
取得或設定協助工具用戶端應用程式使用之控制項的描述。 (繼承來源 Control) |
| AccessibleName |
取得或設定協助工具用戶端應用程式使用的控制項名稱。 (繼承來源 Control) |
| AccessibleRole |
取得或設定控制項的可存取角色。 (繼承來源 Control) |
| AllowDrop |
取得或設定值，指出控制項是否能接受使用者拖放上來的資料。 (繼承來源 Control) |
| Anchor |
取得或設定控制項繫結至的容器邊緣，並決定控制項隨其父代重新調整大小的方式。 (繼承來源 Control) |
| Appearance |
取得或設定值，決定 RadioButton 的外觀。 |
| AutoCheck |
取得或設定值，指出當按一下控制項時，Checked 值和控制項的外觀是否自動變更。 |
| 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 |
取得或設定 RadioButton 的核取方塊部分的位置。 |
| Checked |
取得或設定值，指出是否選取控制項。 |
| 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) 給予這個控制項。 |
| Tag |
取得或設定物件，其包含控制項相關資料。 (繼承來源 Control) |
| Text |
取得或設定這個控制項的相關文字。 (繼承來源 ButtonBase) |
| TextAlign |
取得或設定 RadioButton 控制項上文字的對齊方式。 |
| TextImageRelation |
取得或設定文字和影像彼此之間的相對位置。 (繼承來源 ButtonBase) |
| 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) |
