如何在C#中使用Spreadsheet Gear创建Excel复选框？

1. 正确创建复选框对象的语法 #

Spreadsheet Gear中的复选框属于原生窗体控件，通过IWorksheet.Shapes.AddFormControl方法完成创建，参考代码如下：

// 引入必要命名空间
using SpreadsheetGear;
using SpreadsheetGear.Shapes;

// 获取目标工作表实例
IWorksheet worksheet = workbook.Worksheets[0];
/*
AddFormControl参数说明：
1. 控件类型：指定为FormControlType.CheckBox表示复选框
2. 左上角所在行索引（从0开始计数）
3. 距离行顶部的偏移量（单位：像素）
4. 左上角所在列索引（从0开始计数）
5. 距离列左侧的偏移量（单位：像素）
6. 控件宽度（单位：像素）
7. 控件高度（单位：像素）
*/
IShape checkBoxShape = worksheet.Shapes.AddFormControl(FormControlType.CheckBox, 1, 0, 1, 0, 100, 18);
// 设置复选框显示的文本内容
checkBoxShape.TextFrame.Characters.Text = "选项生效";

注意：此处创建的是Excel原生窗体控件，兼容性优于ActiveX控件，无需启用宏即可正常交互。

2. 为复选框添加Alt文本 #

复选框对应的IShape对象内置AlternativeText属性，直接赋值即可完成Alt文本配置：

checkBoxShape.AlternativeText = "功能开关复选框";

3. 控制复选框的选中/未选中状态 #

你提到的CheckboxTrue/CheckboxFalse相关标识是Spreadsheet Gear内置的ControlValue枚举成员，确实用于控制复选框状态，操作代码如下：

// 设置为选中状态
checkBoxShape.ControlFormat.Value = ControlValue.CheckBoxTrue;
// 设置为未选中状态
checkBoxShape.ControlFormat.Value = ControlValue.CheckBoxFalse;
// 三态复选框可设置为不确定状态
// checkBoxShape.ControlFormat.Value = ControlValue.Mixed;

// 读取当前复选框状态示例
if (checkBoxShape.ControlFormat.Value == ControlValue.CheckBoxTrue)
{
    // 复选框已选中的业务逻辑
}

内容的提问来源于stack exchange，提问作者William Faulkner