Spire.Cloud.Excel 添加、删除 Excel 批注

 

Spire.Cloud.Excel提供的WorksheetsApi接口用于操作Excel中的工作表。本文将介绍如何使用该接口来添加、删除Excel批注。

详细步骤如下:

步骤一:创建一个maven程序,并通过maven仓库安装Spire.Cloud.SDK.jar包及其依赖。详细步骤可参考此篇文章

步骤二:通过冰蓝云官网(https://cloud.e-iceblue.cn/)注册账号并登陆,在“我的应用” 版块创建应用程序,以获得App ID及App Key。

Spire.Cloud.Excel 添加、删除 Excel 批注

步骤三:上传Excel示例文档至冰蓝云官网的“文档管理”版块。

Spire.Cloud.Excel 添加、删除 Excel 批注

步骤四:在Maven程序中编写代码调用WorksheetsApi接口给示例Excel文档添加、删除批注。

示例1、添加Excel批注

import spire.cloud.excel.sdk.*;
import spire.cloud.excel.sdk.api.WorksheetsApi;
import spire.cloud.excel.sdk.model.*;

public class AddComment {
    static String appId = "App ID";
    static String appKey = "App Key";
    static String baseUrl = "https://api.e-iceblue.cn";

    public static void main(String[] args) throws ApiException {
        //配置App ID和App Key
        Configuration configuration = new Configuration(appId, appKey, baseUrl);
        //初始化WorksheetsApi对象
        WorksheetsApi WorksheetsApi = new WorksheetsApi(configuration);
        //示例Excel文档名称
        String name = "Sample.xlsx";
        //存放示例文档的文件夹,如果没有文件夹则为null
        String folder = null;
        //使用冰蓝云配置的2G空间存贮文档,可设置为null
        String storage = null;
        //指定工作表
        String sheetName = "Sheet1";
        //指定添加批注的单元格
        String cellName = "D1";
        //添加批注
        Comment comment = new Comment();
        comment.setAuthor("Tina");//声明批注作者
        comment.setNote("单位:平方公里");//添加批注内容
        comment.setAutoSize(true);
        comment.setTextOrientationType("crosswise");//设置批注方向
        comment.setTextVerticalAlignment("top");//设置批注字体对齐方式
        comment.setIsVisible(true);
        //调用addComment方法添加批注到指定单元格
        WorksheetsApi.addComment(name, sheetName, cellName, comment, folder, storage);
    }
}

添加效果:

Spire.Cloud.Excel 添加、删除 Excel 批注

示例2、删除Excel批注

import spire.cloud.excel.sdk.*;
import spire.cloud.excel.sdk.api.WorksheetsApi;

public class DeleteComment {
    static String appId = "App ID";
    static String appKey = "App Key";
    static String baseUrl = "https://api.e-iceblue.cn";

    public static void main(String[] args) throws ApiException {
        //配置App ID和App Key
        Configuration configuration = new Configuration(appId, appKey, baseUrl);
        //初始化WorksheetsApi对象
        WorksheetsApi WorksheetsApi = new WorksheetsApi(configuration);
        //含有批注的示例Excel文档
        String name = "DeleteComment.xlsx";
        //存放示例文档的文件夹,如果没有文件夹则为null
        String folder = null;
        //使用冰蓝云配置的2G空间存贮文档,可设置为null
        String storage = null;
        //指定工作表
        String sheetName = "Sheet1";
        //调用deleteComments方法删除指定工作表中的批注
        WorksheetsApi.deleteComments(name, sheetName, folder, storage);
    }
}