3.复选框单元格.md

复选框单元格

CheckBox 表示一种复选框单元格类型。当你想在你的页面添加用户可以填写的表单，那么复选框单元格将是非常有用，而且将会很简单的让用户去选择。

创建一个复选框单元格，参照以下代码：

var c = new Excel.View.Sheets.CellTypes.CheckBox();
sheet.setCellType(3, 2, c, Excel.View.Sheets.SheetArea.viewport);

复选框单元格类型 CheckBox 支持三种状态。你可以使用 isThreeState 方法来设置复选框是否支持三种状态。例如：

c.isThreeState(true);
var state = c.isThreeState();

三种状态分别是选中，未选中和不确定状态。每种状态都有对应的文本；你可以使用 textTrue ， textFalse和 textIndeterminate 方法来设置或者获取状态对应的文本。例如：

c.isThreeState(true);
c.textTrue('Check state');
c.textFalse('UnCheck state');
c.textIndeterminate('Indeterminate state');

你可以使用 caption 方法来设置或者获取复选框单元格的标题。使用 textAlign 方法来设置或者获取文本相对于复选框的位置。这个设置是一个枚举 CheckBoxTextAlign， 枚举值如下：

top: 文本在复选框顶部。
bottom: 文本在复选框底部。
left: 文本在复选框左边。
right: 文本在复选框右边。
c.caption('Check Box');
c.textAlign(Excel.View.Sheets.CellTypes.CheckBoxTextAlign.left);