当前位置：首页 > news >正文

WinForm真入门(12)——RadioButton控件详解

news 2025/7/1 23:04:56

一、核心功能与分组机制

1‌、单选特性‌

RadioButton 用于在多个互斥选项中仅允许选择一个选项。‌同一容器（如窗体、GroupBox 或 Panel）内的
RadioButton 默认自动形成互斥分组‌，选中一个会自动取消同组其他选项的选中状态‌。

2‌、分组实现‌

通过 GroupBox 或 Panel 控件划分逻辑分组区域，不同容器内的 RadioButton 互不影响‌。
分组规则‌：同一容器内的 RadioButton 自动为一组，通过设置容器控件的 Group 属性可进一步优化分组逻辑。

二、关键属性与事件

1‌、核心属性‌

属性	说明	案例场景
Checked	是否选中（true/false）	判断用户选择的性别‌
Text	显示选项文本	设置选项内容（如“男”“女”）‌
AutoCheck	是否自动切换选中状态	若设为 false，需手动通过代码控制选中逻辑‌
CheckAlign	单选按钮位置（默认左对齐）	调整按钮与文本的布局‌

2‌、常用事件‌

CheckedChanged‌：选中状态变化时触发，用于动态响应选择操作‌。

private void radioButton1_CheckedChanged(object sender, EventArgs e) {
    if (radioButton1.Checked) {
        MessageBox.Show("选项1被选中");
    }
}

三、使用场景与案例

1‌、案例1：性别选择‌
‌需求‌： 用户从“男”“女”中选择一项，点击按钮后显示结果。
‌实现步骤‌：

拖拽两个 RadioButton 到 GroupBox 中，设置 Text 属性为“男”“女”。
添加“确定”按钮并绑定事件：

private void btnConfirm_Click(object sender, EventArgs e) {
    string gender = "";
    if (radioButtonMale.Checked) gender = radioButtonMale.Text;
    else if (radioButtonFemale.Checked) gender = radioButtonFemale.Text;
    MessageBox.Show($"性别：{gender}");
}

2‌、案例2：动态创建分组‌
**‌需求‌：**运行时动态生成多个 RadioButton 分组。
‌实现代码‌：

// 创建分组容器
GroupBox groupBox = new GroupBox { Text = "动态分组", Location = new Point(20, 20) };
// 添加选项
RadioButton rb1 = new RadioButton { Text = "选项A", Location = new Point(10, 20) };
RadioButton rb2 = new RadioButton { Text = "选项B", Location = new Point(10, 50) };
groupBox.Controls.AddRange(new Control[] { rb1, rb2 });
this.Controls.Add(groupBox);

3‌、案例3：结合 Panel 实现多分组‌
‌需求‌： 在一个界面中实现“颜色选择”和“尺寸选择”两个独立分组。
‌实现步骤‌：

拖拽两个 Panel 控件到窗体，分别命名为 panelColor 和 panelSize。
在每个 Panel 内添加多个 RadioButton。
通过代码获取选中项：

private void ShowSelection() {
    string color = panelColor.Controls.OfType<RadioButton>().FirstOrDefault(rb => rb.Checked)?.Text;
    string size = panelSize.Controls.OfType<RadioButton>().FirstOrDefault(rb => rb.Checked)?.Text;
    MessageBox.Show($"颜色：{color}，尺寸：{size}");
}

四、注意事项

1‌、初始化状态‌

同一分组内必须确保仅一个 RadioButton 的 Checked 属性为 true，否则运行时会自动保留最后一个被初始化的选中项‌。

2‌、事件优化‌

多个 RadioButton 可共享同一 CheckedChanged 事件处理方法，通过 sender 参数判断具体控件‌：

private void SharedCheckedChanged(object sender, EventArgs e) {
    RadioButton rb = sender as RadioButton;
    if (rb != null && rb.Checked) {
        // 根据 rb.Name 或 Text 执行不同逻辑
    }
}