在 .NET 中管理 PowerPoint 演示文稿的 SmartArt

获取 SmartArt 对象的文本

现在 TextFrame 属性已分别添加到 ISmartArtShape 接口和 SmartArtShape 类。此属性允许您获取 SmartArt 中的全部文本，即使它不仅仅是节点文本。以下示例代码将帮助您获取 SmartArt 节点的文本。

using (Presentation pres = new Presentation("Presentation.pptx"))
{
	ISlide slide = pres.Slides[0];
	ISmartArt smartArt = (ISmartArt)slide.Shapes[0];

	ISmartArtNodeCollection smartArtNodes = smartArt.AllNodes;
	foreach (ISmartArtNode smartArtNode in smartArtNodes)
	{
		foreach (ISmartArtShape nodeShape in smartArtNode.Shapes)
		{
			if (nodeShape.TextFrame != null)
				Console.WriteLine(nodeShape.TextFrame.Text);
		}
	}
}

更改 SmartArt 对象的布局类型

为了更改 SmartArt 的布局类型，请按以下步骤操作：

  • 创建 Presentation 类的实例。
  • 通过使用索引获取幻灯片的引用。
  • 添加 SmartArt BasicBlockList。
  • 将 LayoutType 更改为 BasicProcess。
  • 将演示文稿写入为 PPTX 文件。 在下面的示例中，我们在两个形状之间添加了连接线。
using (Presentation presentation = new Presentation())
{
    // 添加 SmartArt BasicProcess 
    ISmartArt smart = presentation.Slides[0].Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicBlockList);

    // 将 LayoutType 更改为 BasicProcess
    smart.Layout = SmartArtLayoutType.BasicProcess;

    // 保存演示文稿
    presentation.Save("ChangeSmartArtLayout_out.pptx", SaveFormat.Pptx);
}

检查 SmartArt 对象的 Hidden 属性

请注意，方法 com.aspose.slides.ISmartArtNode.isHidden() 如果此节点在数据模型中为隐藏节点则返回 true。为了检查 SmartArt 任意节点的 hidden 属性，请按以下步骤操作：

  • 创建 Presentation 类的实例。
  • 添加 SmartArt RadialCycle。
  • 在 SmartArt 上添加节点。
  • 检查 isHidden 属性。
  • 将演示文稿写入为 PPTX 文件。 在下面的示例中，我们在两个形状之间添加了连接线。
using (Presentation presentation = new Presentation())
{
    // 添加 SmartArt BasicProcess 
    ISmartArt smart = presentation.Slides[0].Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.RadialCycle);

    // 在 SmartArt 上添加节点 
    ISmartArtNode node = smart.AllNodes.AddNode();

    // 检查 isHidden 属性
    bool hidden = node.IsHidden; // 返回 true

    if (hidden)
    {
        // 执行一些操作或通知
    }
    // 保存演示文稿
    presentation.Save("CheckSmartArtHiddenProperty_out.pptx", SaveFormat.Pptx);
}

获取或设置组织结构图类型

方法 com.aspose.slides.ISmartArtNode.getOrganizationChartLayout()、setOrganizationChartLayout(int) 允许获取或设置与当前节点关联的组织结构图类型。为了获取或设置组织结构图类型，请按以下步骤操作：

  • 创建 Presentation 类的实例。
  • 在幻灯片上添加 SmartArt。
  • 获取或设置组织结构图类型。
  • 将演示文稿写入为 PPTX 文件。 在下面的示例中，我们在两个形状之间添加了连接线。
using (Presentation presentation = new Presentation())
{
    // 添加 SmartArt BasicProcess 
    ISmartArt smart = presentation.Slides[0].Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.OrganizationChart);

    // 获取或设置组织结构图类型 
    smart.Nodes[0].OrganizationChartLayout = OrganizationChartLayoutType.LeftHanging;

    // 保存演示文稿
    presentation.Save("OrganizeChartLayoutType_out.pptx", SaveFormat.Pptx);
}

创建图片组织结构图

Aspose.Slides for .NET 提供了一个简单的 API，能够轻松创建 PictureOrganization 图表。要在幻灯片上创建图表，请按以下步骤操作：

  1. 创建 Presentation 类的实例。
  2. 通过索引获取幻灯片的引用。
  3. 添加一个默认数据的图表，并指定所需类型 (ChartType.PictureOrganizationChart)。
  4. 将修改后的演示文稿写入 PPTX 文件

以下代码用于创建图表。

public static void Run()
{
	using (Presentation pres = new Presentation("test.pptx"))
	{
		ISmartArt smartArt = pres.Slides[0].Shapes.AddSmartArt(0, 0, 400, 400, SmartArtLayoutType.PictureOrganizationChart);
		pres.Save("OrganizationChart.pptx", SaveFormat.Pptx);
	}			
}

常见问题

SmartArt 是否支持 RTL 语言的镜像/反转？

是的。如果所选的 SmartArt 类型支持反转，IsReversed 属性会切换图表方向（LTR/RTL）。

如何在保持格式的情况下将 SmartArt 复制到同一幻灯片或其他演示文稿中？

您可以通过形状集合克隆 SmartArt 形状（ShapeCollection.AddClone）或克隆包含该形状的整个幻灯片。这两种方法都能保留大小、位置和样式。

如何将 SmartArt 渲染为栅格图像以进行预览或网页导出？

渲染幻灯片（或整个演示文稿）为 PNG/JPEG，可通过将幻灯片/演示文稿转换为图像的 API 实现——SmartArt 将作为幻灯片的一部分绘制。

如果幻灯片上有多个 SmartArt，如何以编程方式选择特定的 SmartArt？

常用做法是使用替代文本（Alt Text）或名称，在Slide.Shapes 中按该属性搜索形状，然后检查其类型以确认是SmartArt。文档中描述了查找和操作形状的典型技术。

在 .NET 中管理演示文稿中的 SmartArt 图形