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

创建 SmartArt 形状

Aspose.Slides for .NET 现在可以从零在幻灯片中添加自定义 SmartArt 形状。Aspose.Slides for .NET 提供了最简洁的 API，以最容易的方式创建 SmartArt 形状。要在幻灯片中创建 SmartArt 形状，请按以下步骤操作：

• 创建 Presentation 类的实例。
• 使用索引获取幻灯片的引用。
• 通过设置 LayoutType 添加 SmartArt 形状。
• 将修改后的演示文稿写入为 PPTX 文件。

// 实例化演示文稿
using (Presentation pres = new Presentation())
{

    // 访问演示文稿幻灯片
    ISlide slide = pres.Slides[0];

    // 添加 Smart Art 形状
    ISmartArt smart = slide.Shapes.AddSmartArt(0, 0, 400, 400, SmartArtLayoutType.BasicBlockList);

    // 保存演示文稿
    pres.Save("SimpleSmartArt_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

访问 幻灯片上的 SmartArt 形状

下面的代码用于访问添加到演示文稿幻灯片中的 SmartArt 形状。在示例代码中，我们将遍历幻灯片中的每个形状并检查它是否为 SmartArt 形状。如果该形状是 SmartArt 类型，则将其强制转换为 SmartArt 实例。

 // 加载所需的演示文稿
using (Presentation pres = new Presentation("AccessSmartArtShape.pptx"))
{

    // 遍历第一张幻灯片中的每个形状
    foreach (IShape shape in pres.Slides[0].Shapes)
    {
        // 检查形状是否为 SmartArt 类型
        if (shape is ISmartArt)
        {
            // 将形状强制转换为 SmartArtEx
            ISmartArt smart = (ISmartArt)shape;
            System.Console.WriteLine("Shape Name:" + smart.Name);

        }
    }
}

使用特定布局类型访问 SmartArt 形状

下面的示例代码可帮助访问具有特定 LayoutType 的 SmartArt 形状。请注意，SmartArt 的 LayoutType 为只读，且只能在添加 SmartArt 形状时设置，无法更改。

• 创建 Presentation 类的实例并加载包含 SmartArt 形状的演示文稿。
• 使用索引获取第一张幻灯片的引用。
• 遍历第一张幻灯片中的所有形状。
• 检查形状是否为 SmartArt 类型，如果是，则将选定形状强制转换为 SmartArt。
• 检查具有特定 LayoutType 的 SmartArt 形状，并执行后续所需操作。

using (Presentation presentation = new Presentation("AccessSmartArtShape.pptx"))
{
    // 遍历第一张幻灯片中的每个形状
    foreach (IShape shape in presentation.Slides[0].Shapes)
    {
        // 检查形状是否为 SmartArt 类型
        if (shape is ISmartArt)
        {
            // 将形状强制转换为 SmartArtEx
            ISmartArt smart = (ISmartArt) shape;

            // 检查 SmartArt 布局
            if (smart.Layout == SmartArtLayoutType.BasicBlockList)
            {
                Console.WriteLine("Do some thing here....");
            }
        }
    }
}

更改 SmartArt 形状样式

下面的示例代码将帮助访问具有特定 LayoutType 的 SmartArt 形状。

• 创建 Presentation 类的实例并加载包含 SmartArt 形状的演示文稿。
• 使用索引获取第一张幻灯片的引用。
• 遍历第一张幻灯片中的所有形状。
• 检查形状是否为 SmartArt 类型，如果是，则将选定形状强制转换为 SmartArt。
• 查找具有特定 Style 的 SmartArt 形状。
• 为 SmartArt 形状设置新的 Style。
• 保存演示文稿。

using (Presentation presentation = new Presentation("AccessSmartArtShape.pptx"))
{
    // 遍历第一张幻灯片中的每个形状
    foreach (IShape shape in presentation.Slides[0].Shapes)
    {
        // 检查形状是否为 SmartArt 类型
        if (shape is ISmartArt)
        {
            // 将形状强制转换为 SmartArtEx
            ISmartArt smart = (ISmartArt)shape;

            // 检查 SmartArt 样式
            if (smart.QuickStyle == SmartArtQuickStyleType.SimpleFill)
            {
                // 更改 SmartArt 样式
                smart.QuickStyle = SmartArtQuickStyleType.Cartoon;
            }
        }
    }

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

更改 SmartArt 形状颜色样式

在本示例中，我们将学习如何更改任意 SmartArt 形状的颜色样式。下面的示例代码将访问具有特定颜色样式的 SmartArt 形状并更改其样式。

• 创建 Presentation 类的实例并加载包含 SmartArt 形状的演示文稿。
• 使用索引获取第一张幻灯片的引用。
• 遍历第一张幻灯片中的所有形状。
• 检查形状是否为 SmartArt 类型，如果是，则将选定形状强制转换为 SmartArt。
• 查找具有特定 Color Style 的 SmartArt 形状。
• 为 SmartArt 形状设置新的 Color Style。
• 保存演示文稿。

using (Presentation presentation = new Presentation("AccessSmartArtShape.pptx"))
{
    // 遍历第一张幻灯片中的每个形状
    foreach (IShape shape in presentation.Slides[0].Shapes)
    {
        // 检查形状是否为 SmartArt 类型
        if (shape is ISmartArt)
        {
            // 将形状强制转换为 SmartArtEx
            ISmartArt smart = (ISmartArt)shape;

            // 检查 SmartArt 颜色类型
            if (smart.ColorStyle == SmartArtColorType.ColoredFillAccent1)
            {
                // 更改 SmartArt 颜色类型
                smart.ColorStyle = SmartArtColorType.ColorfulAccentColors;
            }
        }
    }

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

FAQ

我可以将 SmartArt 作为单个对象进行动画处理吗？

是的。SmartArt 本质上是一个形状，因此您可以通过动画 API 为其应用标准动画（进入、退出、强调、运动路径），就像其他形状一样。

如果我不知道内部 ID，如何在幻灯片上找到特定的 SmartArt？

设置并使用替代文本 (AltText)，并通过该值搜索形状——这是定位目标形状的推荐方法。

我可以将 SmartArt 与其他形状分组吗？

可以。您可以将 SmartArt 与其他形状（图片、表格等）分组，然后操作该组。

如何获取特定 SmartArt 的图像（例如用于预览或报告）？

导出该形状的缩略图/图像；库能够将单个形状渲染为光栅文件（PNG/JPG/TIFF）。

将整个演示文稿转换为 PDF 时，SmartArt 外观会被保留吗？

是的。渲染引擎在PDF 导出时旨在实现高保真度，并提供多种质量和兼容性选项。