表单保护与锁定单元格

SpreadJS 允许您保护锁定所有单元格的工作表并防止其他用户更改、移动或删除数据。但是，您仍然可以从锁定的单元格中复制数据。

isProtected 选项可以设置为 true 以保护工作表和锁定方法可用于锁定或解锁单元格。

解锁受保护工作表中的单元格

您可以通过将 locked 方法设置为False，允许用户编辑受保护工作表中的特定单元格。

sheet.getCell(1,1, GC.Spread.Sheets.SheetArea.viewport).locked(false);
sheet.setValue(1,1,"unLocked");
sheet.getRange(-1,3, -1, 1).locked(false);
sheet.getRange(5, -1, 1, -1).locked(false);
sheet.options.isProtected = true;

在受保护的工作表中锁定一系列单元格

您可以按照以下步骤选择锁定受保护工作表中特定范围的单元格：

通过创建自定义样式并将 locked 方法设置为 False 来解锁所有单元格。
单独锁定您想要只读的单元格范围。

// 配置工作簿和工作表
var spread = new GC.Spread.Sheets.Workbook("ss");
var sheet = spread.getActiveSheet();
// Unlock all the cells in the worksheet via the styles
let style = new GC.Spread.Sheets.Style();
style.locked = false;
// 将样式设置为工作表中所有单元格的默认样式
sheet.setDefaultStyle(style);
// 单独锁定你想只读的单元格范围
new GC.Spread.Sheets.CellRange(sheet, 0, 0, 13, 4).locked(true);
// 设置要保护的工作表
sheet.options.isProtected = true;

options.protectionOptions 属性可用于指定可以更改的区域。这些区域可以包括调整大小、拖动、插入或删除行或列等。

isProtected 选项设置为true时，以下属性设置为True时生效：

特性	说明
allowDragInsertRows	允许您在插入行时执行拖动操作。
allowDragInsertColumns	允许您在插入列时执行拖动操作。
allowInsertRows	允许您插入行。
allowInsertColumns	允许您插入列。
allowDeleteRows	允许您删除行。
allowDeleteColumns	允许您删除列。
allowSelectLockedCells	允许您选择锁定的单元格。
allowSelectUnlockedCells	允许您选择未锁定的单元格。
allowSort	允许您对范围进行排序。
allowFilter	允许筛选范围。
allowEditObjects	允许您编辑浮动对象。
allowResizeRows	允许您调整行大小。
allowResizeColumns	允许您调整列的大小。
allowOutlineRows	允许您展开或折叠行组。
allowOutlineColumns	允许您展开或折叠列组。

当 isProtected 选项设置为false时，上述保护选项将不起作用。

在锁定的工作表中启用保护选项

您可以保护工作表并启用 SpreadJS 中可用的各种保护选项。

var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));
var sheet = spread.getActiveSheet();
sheet.options.isProtected = true;
sheet.options.protectionOptions.allowDeleteRows  = true;
sheet.options.protectionOptions.allowDeleteColumns = true;
sheet.options.protectionOptions.allowInsertRows = true;
sheet.options.protectionOptions.allowInsertColumns = true;
sheet.options.protectionOptions.allowDargInsertRows = true;
sheet.options.protectionOptions.allowDragInsertColumns = true;

type=warning
注意: 保护选项：allowInsertRows，allowInsertColumns，allowDeleteRows和allowDeleteColumns仅在用户界面上执行操作时可用。换句话说，该值将仅限制上下文菜单中行和列的插入和删除命令。

为受保护组设置警告消息

默认情况下，您不能在受保护的工作表中展开或折叠大纲行或列组。触发了 invalidOperation 事件，您还可以绑定该事件以显示警告消息，如下所示：

// Set alert message
spread.bind(GC.Spread.Sheets.Events.InvalidOperation, (e, args) => {
    if(args.invalidType === GC.Spread.Sheets.InvalidOperationType.groupProtected){
    args.message="Expand or Collapse operation is not allowed for a protected worksheet.";
    alert(args.message)
    }
});

用密码保护工作表

您可以选择在使用protect方法保护工作表的同时设置密码。但是，在调用 protect 方法时，isProtected选项将自动设置为 true。

//Protect the worksheet 
var password = 'AddedPassword'; 
activeSheet.protect(password);

您可以通过将密码作为参数提供给取消保护方法来进一步取消对工作表的保护。

//unprotect the worksheet with a password
if(activeSheet.hasPassword()) {
    activeSheet.unprotect(password);
} else {
    activeSheet.unprotect();
}