Spire.Cloud.Word 为开发人员提供了 ShapesApi 接口用于操作Word文档中的形状。本文将介绍如何使用该接口在 Word 文档中添加和删除形状。
详细步骤如下:
步骤一、创建一个 Maven 程序,通过 Maven 仓库安装 Spire.Cloud.SDK jar 包及依赖,详细步骤可参考这篇文章。
步骤二、通过冰蓝云官网(https://cloud.e-iceblue.cn/)注册账号并登陆,在“我的应用”版块创建应用程序,获取你的 App ID 及 App Key。
步骤三、上传 Word 文档至冰蓝云官网的“文档管理”版块。为了便于文档管理,您也可以先创建文件夹 "input" 和 "output",然后将需要编辑的 Word 文档上传至 input 文件夹下,output 文件夹用于存放生成的文档。
步骤四、在 Java 程序中编写代码来添加、删除 Word 形状。
示例 1、添加形状
import spire.cloud.word.sdk.client.*;
import spire.cloud.word.sdk.client.api.ShapesApi;
import spire.cloud.word.sdk.client.model.*;
public class addShape {
static String appId = "APP ID";
static String appKey = "APP Key";
static String baseUrl = "https://api.e-iceblue.cn";
//配置App ID和App Key
static Configuration wordConfiguration = new Configuration(appId, appKey, baseUrl);
//创建ShapesApi实例
static ShapesApi shapesApi = new ShapesApi(wordConfiguration);
public static void main(String[] args) throws ApiException {
//示例文档名称
String name = "addShape.docx";
//段落路径
String paragraphPath = "Section/0/Body/0/Paragraph/0";
//需要添加形状的段落
int indexInParagraph = 1;
//存放示例文档的文件夹,没有则为null
String folder = "input";
//使用冰蓝云配置的2G空间存贮文档,可设置为null
String storage = null;
//示例文档密码,没有则为null
String password = null;
//创建形状,并设置其形状类型、位置、填充颜色、旋转角度、文字环绕方式等
ShapeFormat shapeFormat = new ShapeFormat(40f, 40f, ShapeFormat.ShapeTypeEnum.RECTANGLE);
shapeFormat.setHorizontalOrigin(ShapeFormat.HorizontalOriginEnum.PAGE);
shapeFormat.setVerticalOrigin(ShapeFormat.VerticalOriginEnum.PARAGRAPH);
shapeFormat.setVerticalPosition(50f);
shapeFormat.setHorizontalPosition(150f);
Color color = new Color(0, 206, 209);
shapeFormat.setFillColor(color);
shapeFormat.setRotation(45f);
shapeFormat.setStrokeWeight(2f);
Color color_2 = new Color(173, 255, 47);
shapeFormat.setStrokeColor(color_2);
shapeFormat.setTextWrappingType(ShapeFormat.TextWrappingTypeEnum.BOTH);
shapeFormat.setTextWrappingStyle(ShapeFormat.TextWrappingStyleEnum.INFRONTOFTEXT);
shapeFormat.setZOrder(1);
ShapeFormat shapeProperties = shapeFormat;
//指定生成文档的存放路径
String destFilePath = "output/addShape_output.docx";
//调用addShape方法添加形状到Word文档
shapesApi.addShape(name, paragraphPath, shapeFormat, destFilePath,folder, storage, indexInParagraph, password);
}
}
使用 Spire.Cloud 在线编辑查看添加形状后的 Word文 档效果图:
示例 2、删除形状
import spire.cloud.word.sdk.client.*;
import spire.cloud.word.sdk.client.api.ShapesApi;
public class deleteShape {
static String appId = "APP ID";
static String appKey = "APP Key";
static String baseUrl = "https://api.e-iceblue.cn";
//配置App ID和App Key
static Configuration wordConfiguration = new Configuration(appId, appKey, baseUrl);
//创建ShapesApi实例
static ShapesApi shapesApi = new ShapesApi(wordConfiguration);
public static void main(String[] args) throws ApiException {
//示例文档名称
String name = "getShape.docx";
//段落路径
String paragraphPath = "Section/0/Body/0/Paragraph/0";
//指定需要删除形状的索引
Integer index = 1;
//存放示例文档的文件夹,没有则为null
String folder = "input";
//使用冰蓝云配置的2G空间存贮文档,可设置为null
String storage = null;
//示例文档密码,没有则为null
String password = null;
//指定生成文档的存放路径
String destFilePath = "output/deleteShape.docx";
//调用deleteShape方法删除Word文档中的形状
shapesApi.deleteShape(name, paragraphPath, index, destFilePath, folder, storage, password);
}
}