通过 C++ 使用 Node.js 锁定或解锁形状

可能的使用场景

有时，您需要保护工作表中的所有形状，以防止它们被不需要的情况破坏。在这种情况下，您需要锁定指定工作表中的所有形状。

在电子表格或文档中锁定形状可能有多种好处：

1. 防止意外更改：锁定形状可确保用户不小心移动、调整大小或删除它们。这在复杂文档中尤为重要，形状可能用于注释、插图或作为文档设计的一部分。
2. 维护布局和设计：形状常在文档的布局和视觉设计中发挥关键作用。锁定它们可保持预期外观，确保文档保持专业和视觉吸引力。
3. 数据完整性：在电子表格中，形状可用来突出重要数据点、添加注释或提供视觉解释。锁定这些形状可确保它们提供的上下文信息保持准确完整。
4. 共享文档中的一致性：协作时，不同用户可能具有不同的专业水平。锁定形状有助于保持文档的一致性，防止意外更改。
5. 安全性：在敏感文档中，锁定形状可以作为保护信息的整体策略的一部分。例如，在财务报告或法律文件中，锁定形状可用来保护关键的注释或高亮部分，提供重要上下文。

有时，您需要在某些受保护的工作表中修改特定的形状，此时需要解锁这些形状。本文将详细介绍如何锁定和解锁指定的形状。

如何在Excel中锁定形状以保护它们

下面介绍在Microsoft Excel中锁定单元格的方法：

1. 打开您的Excel文件：打开包含您要锁定的形状的Excel文件。

2. 选择形状：点击您要锁定的形状。也可以按住 Ctrl 键同时点击多个形状以选择。

3. 打开“格式形状”窗格：右键点击已选的形状，选择“大小和属性”。或者，在“开始”选项卡中，点击“格式”区域中的对话框启动器（一个小箭头）打开“格式形状”窗格。

4. 锁定形状：在“格式形状”窗格中，转到“大小与属性”选项卡（图标像一个带箭头的方块）。在“属性”部分，勾选“已锁定”。
   

5. 保护工作表：在功能区的“审阅”选项卡中，点击“保护工作表”。设置密码（可选）并选择你想允许的权限（例如选择锁定单元格、设置单元格格式等）。点击“确定”。
   

如何在指定工作表中锁定所有形状

要保护指定工作表中的所有形状，可以使用 worksheet.protect(ProtectionType.Objects) 方法，示例如下。

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");
const filePath = path.join(dataDir, "sample.xlsx");
// Loads the workbook which contains hidden external links
const workbook = new AsposeCells.Workbook(filePath);

const text = "This is a test";
const worksheet = workbook.getWorksheets().get(0);

let shape = worksheet.getShapes().addTextBox(1, 0, 1, 0, 30, 100);
shape.setText(text);

shape = worksheet.getShapes().addRectangle(5, 0, 1, 0, 30, 100);
shape.setText(text);

shape = worksheet.getShapes().addButton(9, 0, 1, 0, 30, 100);
shape.setText(text);

shape = worksheet.getShapes().addOval(13, 0, 1, 0, 50, 100);
shape.setText(text);

// Protect all shapes in a specified worksheet 
shape.getWorksheet().protect(AsposeCells.ProtectionType.Objects); // Protects the entire worksheet.
// or shape.getWorksheet().protect(AsposeCells.ProtectionType.All); // Protects all shapes in the specified worksheet.
// or worksheet.protect(AsposeCells.ProtectionType.Objects); // Protects the entire worksheet.
// or worksheet.protect(AsposeCells.ProtectionType.All); // Protects all shapes in the specified worksheet.

workbook.save("Locked.xlsx", AsposeCells.SaveFormat.Xlsx);

如何在受保护的工作表中解锁指定形状

要解锁受保护工作表中的特定形状，可使用 shape.isLocked，示例代码如下。

注意：shape.isLocked 仅在工作表已被保护的情况下有意义。

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");
const filePath = path.join(dataDir, "Locked.xlsx");

// Loads the workbook which contains hidden external links
const workbook = new AsposeCells.Workbook(filePath);

// Get protected worksheet
const worksheet = workbook.getWorksheets().get(0);

// Get the specified shape to be unlocked
const shape = worksheet.getShapes().get("TextBox 1");

// Unlock the specified shape
if (!worksheet.getProtection().getAllowEditingObject() && shape.isLocked()) {
shape.setIsLocked(false);
}

workbook.save("UnLocked.xlsx", AsposeCells.SaveFormat.Xlsx);