使用 Java 管理 PowerPoint 演示文稿中的 SmartArt
概述
SmartArt 是由节点、节点形状和布局构成的 PowerPoint 图表。使用 Aspose.Slides for Java,您可以创建 SmartArt、读取其节点中的文本、更改布局、检查隐藏节点、配置组织结构图布局,以及创建图片组织结构图。
获取 SmartArt 对象的文本
SmartArt 节点可以包含一个或多个形状。要读取节点形状中的文本,请遍历 ISmartArt.getAllNodes,然后读取由 ISmartArtShape.getTextFrame 返回的 ITextFrame。
该示例需要一个至少包含一张幻灯片且在该幻灯片上第一个形状为 SmartArt 对象的演示文稿。它会将每个可用的文本框打印到控制台。
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
ISmartArt smartArt = (ISmartArt) slide.getShapes().get_Item(0);
for (ISmartArtNode node : smartArt.getAllNodes()) {
for (ISmartArtShape nodeShape : node.getShapes()) {
if (nodeShape.getTextFrame() != null) {
System.out.println(nodeShape.getTextFrame().getText());
}
}
}
} finally {
presentation.dispose();
}
更改 SmartArt 对象的布局类型
SmartArt 布局决定节点的排列和连接方式。以下示例使用 SmartArtLayoutType BasicBlockList 值创建 SmartArt 对象,将其更改为 BasicProcess 值,并保存演示文稿。传递给 IShapeCollection.addSmartArt 的位置和大小以点为单位。使用 ISmartArt.setLayout 可更改布局。
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
ISmartArt smartArt = slide.getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicBlockList);
smartArt.setLayout(SmartArtLayoutType.BasicProcess);
presentation.save("ChangeSmartArtLayout.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
检查 SmartArt 节点是否隐藏
ISmartArtNode.isHidden 指示该节点在 SmartArt 数据模型中是否隐藏。即使所选布局未将其显示为可见的图表元素,隐藏节点仍可能存在于结构中。
以下示例向使用 SmartArtLayoutType RadialCycle 值的 SmartArt 对象添加一个节点,并检查该添加节点的隐藏状态。如果节点被隐藏,则打印一条消息并保存该图表。
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
ISmartArt smartArt = slide.getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.RadialCycle);
ISmartArtNode node = smartArt.getAllNodes().addNode();
boolean isHidden = node.isHidden();
if (isHidden) {
System.out.println("The node is hidden in the SmartArt data model.");
}
presentation.save("CheckSmartArtHiddenProperty.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
获取或设置组织结构图布局
对于使用组织结构图布局的 SmartArt 图表,ISmartArtNode.getOrganizationChartLayout 和 ISmartArtNode.setOrganizationChartLayout 定义子节点在父节点下的排列方式。例如,您可以根据所选的 OrganizationChartLayoutType 将子节点悬挂在左侧、右侧或两侧。
以下示例创建一个组织结构图,并将首个节点的布局设置为 OrganizationChartLayoutType LeftHanging 值。零基索引 0 选择第一个顶层节点;其子节点使用所选的排列方式。随后保存修改后的演示文稿。
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
ISmartArt smartArt = slide.getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.OrganizationChart);
ISmartArtNode rootNode = smartArt.getNodes().get_Item(0);
rootNode.setOrganizationChartLayout(OrganizationChartLayoutType.LeftHanging);
presentation.save("OrganizationChartLayout.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
创建图片组织结构图
图片组织结构图是一种为包含图像占位符的层级图表设计的 SmartArt 布局。将 SmartArt 对象添加到幻灯片时,请使用 SmartArtLayoutType PictureOrganizationChart 值。此示例保存了带有图像占位符的图表,但不会用图像填充这些占位符。
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
ISmartArt smartArt = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.PictureOrganizationChart);
presentation.save("PictureOrganizationChart.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
将旧版图表转换为形状组
在现代化现有演示文稿时,您可能需要更新最初在 PowerPoint 97–2003 中创建的组织结构图。Aspose.Slides 将这些旧版图表表示为 ILegacyDiagram 对象。使用 LegacyDiagram.convertToGroupShape 可将图表转换为形状组,以便编辑各个可视元素。有关详细信息,请参阅 LegacyDiagram API Reference。
转换会在形状集合中添加一个新组,而不会删除原始图表。转换成功后,请使用 IShapeCollection.remove 删除原始图表,以避免重复内容。在转换之前,将旧版图表收集到列表中,以免在添加和删除形状时破坏迭代。
以下示例打开演示文稿,遍历每张幻灯片,将图表转换为形状组,并将更新后的演示文稿保存为 PPTX。
import com.aspose.slides.*;
import java.util.ArrayList;
import java.util.List;
Presentation presentation = new Presentation("legacy-diagrams.ppt");
try {
for (ISlide slide : presentation.getSlides()) {
List<ILegacyDiagram> legacyDiagrams = new ArrayList<>();
for (IShape shape : slide.getShapes()) {
if (shape instanceof ILegacyDiagram) {
legacyDiagrams.add((ILegacyDiagram) shape);
}
}
for (ILegacyDiagram legacyDiagram : legacyDiagrams) {
IGroupShape groupShape = legacyDiagram.convertToGroupShape();
if (groupShape != null) {
slide.getShapes().remove(legacyDiagram);
}
}
}
presentation.save("modernized.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
保存的演示文稿在已转换的旧版图表位置上包含可编辑的形状组,不再保留原始图表。使用 PowerPoint 打开该 PPTX,即可编辑每个组内的各个元素,如文本、填充或位置。
常见问题
SmartArt 是否支持对 RTL(从右到左)语言的镜像或反转?
是的。当所选 SmartArt 布局支持反转时,ISmartArt.setReversed 方法可将图表方向从从左到右切换为从右到左,或反之。
如何在保持格式的情况下将 SmartArt 复制到同一幻灯片或其他演示文稿?
您可以通过 克隆 SmartArt 形状 与 ShapeCollection.addClone 或者 克隆整个幻灯片 来实现。两种方法都能保留大小、位置和格式。
如何将 SmartArt 渲染为栅格图像以进行预览或网络导出?
将幻灯片 渲染 或整个演示文稿为 PNG 或 JPEG。SmartArt 将作为幻灯片的一部分进行渲染。
如果幻灯片上有多个 SmartArt 对象,如何查找特定的 SmartArt 对象?
使用 Shape.setAlternativeText 或 Shape.setName 为 SmartArt 形状分配唯一的替代文本或名称,在 BaseSlide.getShapes 中搜索该值,然后确认匹配的形状是 ISmartArt。