[]
为了帮助视障人士理解形状的内容，用户可以为形状添加替代文本（alt文本）。当使用屏幕阅读器访问内容时，相关的替代文本会被识别并朗读出来，使用户能够更好地理解形状的用途或含义。
GcExcel Java提供了IShape接口的setTitle、setAlternativeText和setDecorative方法，这些方法用于设置形状替代文本的标题和内容，或指示该形状是否为装饰性形状。
方法 | 说明 |
|---|---|
为形状的替代文本设置标题。 | |
为形状的替代文本设置主要内容。 | |
指示形状是否为装饰性的。当设置为true时，该形状会被标记为装饰性形状，通常会被屏幕阅读器忽略。
默认值：false。 |
形状以及图片、图表、切片器、组合形状、链接图片和控件都支持替代文本。
SpreadJS不支持setDecorative方法。如果一个文件设置了setDecorative方法并导出为SJS或SSJSON格式，Decorative设置将不会被保留。
参考以下示例代码为形状添加替代文本。
// 创建一个新工作簿
Workbook workbook = new Workbook();
IWorksheet worksheet = workbook.getActiveSheet();
// 添加一个圆角矩形形状
IShape shape = worksheet.getShapes().addShape(AutoShapeType.RoundedRectangle, 10, 10, 200, 100);
// 设置替代文本
shape.setTitle("测试形状");
shape.setAlternativeText("这是一个圆角矩形。");
// 保存为Excel文件
workbook.save("SetShapeAltText.xlsx");输出结果如下图所示：
参考以下示例代码将形状标记为装饰性形状。
// 创建一个新工作簿
Workbook workbook = new Workbook();
IWorksheet worksheet = workbook.getActiveSheet();
// 添加一个圆角矩形形状
IShape shape = worksheet.getShapes().addShape(AutoShapeType.RoundedRectangle, 10, 10, 200, 100);
// 设置替代文本
shape.setTitle("测试形状");
shape.setAlternativeText("这是一个圆角矩形。");
// 当形状被标记为装饰性时，替代文本将被清除
shape.setDecorative(true);
// 保存为Excel文件
workbook.save("SetShapeAltText.xlsx");输出结果如下图所示：
