在C#的桌面应用开发中，CheckBox复选框是承载用户多选操作、状态切换需求的核心控件，广泛应用于设置项选择、权限勾选、功能开关等场景。不同开发框架下的CheckBox用法存在差异，同时也有很多通用的开发规范需要遵守。
WinForms平台下CheckBox的基础用法
基础属性设置
WinForms中的CheckBox控件核心属性包括Text、Checked、CheckState，可以通过设计器拖拽或者代码动态设置：
// 动态创建CheckBox并设置基础属性 CheckBox checkBox1 = new CheckBox(); checkBox1.Text = "启用自动保存"; // 显示文本 checkBox1.Location = new Point(20, 20); // 位置 checkBox1.Checked = false; // 初始未选中状态 // CheckState有三种值：Unchecked（未选中）、Checked（选中）、Indeterminate（不确定） checkBox1.CheckState = CheckState.Unchecked; // 将控件添加到窗体 this.Controls.Add(checkBox1);
状态获取与事件处理
获取CheckBox的选中状态通常有两种方式，同时可以绑定CheckedChanged事件响应状态变化：
// 获取选中状态
bool isChecked = checkBox1.Checked;
// 或者获取详细状态
CheckState currentState = checkBox1.CheckState;
// 绑定状态变化事件
checkBox1.CheckedChanged += CheckBox1_CheckedChanged;
// 事件处理方法
private void CheckBox1_CheckedChanged(object sender, EventArgs e)
{
CheckBox cb = sender as CheckBox;
if (cb != null)
{
if (cb.Checked)
{
MessageBox.Show("复选框已被选中");
}
else
{
MessageBox.Show("复选框已被取消选中");
}
}
}
WPF平台下CheckBox的基础用法
XAML中定义CheckBox
WPF的CheckBox通常在XAML中声明，通过属性绑定实现状态同步：
<Window x:Class="WpfApp.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
Title="MainWindow" Height="450" Width="800">
<Grid>
<CheckBox x:Name="wpfCheckBox"
Content="开启夜间模式"
IsChecked="{Binding IsNightMode}"
Checked="WpfCheckBox_Checked"
Unchecked="WpfCheckBox_Unchecked"
HorizontalAlignment="Left"
VerticalAlignment="Top"
Margin="20,20,0,0"/>
</Grid>
</Window>
后台逻辑处理
WPF中可以通过后台代码直接操作CheckBox，也可以结合MVVM模式实现数据绑定：
// 后台直接获取状态
private void GetCheckBoxState()
{
bool? isChecked = wpfCheckBox.IsChecked; // WPF的IsChecked是bool?类型，可空
if (isChecked == true)
{
Console.WriteLine("夜间模式已开启");
}
else if (isChecked == false)
{
Console.WriteLine("夜间模式已关闭");
}
else
{
Console.WriteLine("复选框处于不确定状态");
}
}
// 事件处理方法
private void WpfCheckBox_Checked(object sender, RoutedEventArgs e)
{
// 选中时的逻辑
}
private void WpfCheckBox_Unchecked(object sender, RoutedEventArgs e)
{
// 取消选中时的逻辑
}
CheckBox使用的注意事项
- WinForms的
Checked属性是bool类型，只有true和false两种值，而CheckState属性支持三种状态，如果需要三态选择要设置ThreeState属性为true。 - WPF的
IsChecked是bool?可空类型，判断时要考虑null的情况，避免空引用异常。 - 不要在
CheckedChanged或者Checked事件中执行耗时操作，否则会导致界面卡顿，耗时操作应该放到异步线程中处理。 - 动态创建CheckBox时，要注意控件的生命周期，避免重复添加导致界面异常，批量创建时建议使用控件数组管理。
- 三态CheckBox的不确定状态通常需要手动设置，不会通过用户点击自动切换，一般用于表示子项部分选中的父级状态场景。
常见问题解答
如何批量获取多个CheckBox的选中状态？
可以将同组的CheckBox放到容器控件中，遍历容器内的控件进行判断：
// WinForms中遍历Panel内的所有CheckBox
List<string> selectedItems = new List<string>();
foreach (Control control in panel1.Controls)
{
if (control is CheckBox cb && cb.Checked)
{
selectedItems.Add(cb.Text);
}
}
如何禁用CheckBox但保留文本显示？
设置Enabled属性为false即可，此时用户无法点击修改状态，但文本正常显示：
// WinForms禁用CheckBox checkBox1.Enabled = false; // WPF禁用CheckBox wpfCheckBox.IsEnabled = false;