# 在 C++ 中创建演示文稿形状的缩略图

> 使用 Aspose.Slides for C++ 从 PowerPoint 幻灯片生成高质量的形状缩略图–轻松创建和导出演示文稿缩略图。

Source: https://docs.aspose.com/slides/zh/cpp/shape-thumbnails/
Updated: 2025-12-10


## **创建形状缩略图**
Aspose.Slides for C++ 用于创建每页都是幻灯片的演示文件。这些幻灯片可以通过 Microsoft PowerPoint 打开进行查看。但有时，开发人员可能需要在图像查看器中单独查看形状的图像。此时，Aspose.Slides for C++ 可帮助您生成幻灯片形状的缩略图。本文介绍了如何使用此功能。

本文说明了以不同方式生成幻灯片缩略图的方法：

- 在幻灯片内部生成形状缩略图。  
- 为幻灯片形状生成具有用户定义尺寸的缩略图。  
- 在形状外观的边界内生成形状缩略图。  
- 生成 SmartArt 子节点的缩略图。

## **从幻灯片生成形状缩略图**
使用 Aspose.Slides for C++ 从任意幻灯片生成形状缩略图的方法：

1. 创建一个 [Presentation](https://reference.aspose.com/slides/cpp/aspose.slides/presentation/) 类的实例。  
2. 使用其 ID 或索引获取任意幻灯片的引用。  
3. 获取引用幻灯片的默认比例形状缩略图图像。  
4. 将缩略图图像保存为任意所需的图像格式。

下面的示例生成形状缩略图。
```cpp
auto presentation = MakeObject<Presentation>(u"HelloWorld.pptx");
auto shape = presentation->get_Slide(0)->get_Shape(0);

auto image = shape->GetImage();
image->Save(u"Shape_thumbnail_out.png", ImageFormat::Png);
image->Dispose();

presentation->Dispose();
```


## **生成用户自定义缩放因子的缩略图**
使用 Aspose.Slides for C++ 为任意幻灯片形状生成形状缩略图的方法：

1. 创建一个 [Presentation](https://reference.aspose.com/slides/cpp/aspose.slides/presentation/) 类的实例。  
2. 使用其 ID 或索引获取任意幻灯片的引用。  
3. 获取带有形状边界的引用幻灯片的缩略图图像。  
4. 将缩略图图像保存为任意所需的图像格式。

下面的示例生成具有用户自定义缩放因子的缩略图。
```cpp
auto bounds = ShapeThumbnailBounds::Shape;
auto scale = 1; // 沿 X 和 Y 轴的缩放。

auto presentation = MakeObject<Presentation>(u"HelloWorld.pptx");
auto shape = presentation->get_Slide(0)->get_Shape(0);

auto image = shape->GetImage(bounds, scale, scale);
image->Save(u"Scaling Factor Thumbnail_out.png", ImageFormat::Png);
image->Dispose();

presentation->Dispose();
```


## **创建基于边界的形状外观缩略图**
此方法允许开发人员在形状外观的边界内生成缩略图，并考虑所有形状效果。生成的形状缩略图受幻灯片边界限制。要在形状外观边界内生成任意幻灯片形状的缩略图，请使用以下示例代码：

1. 创建一个 [Presentation](https://reference.aspose.com/slides/cpp/aspose.slides/presentation/) 类的实例。  
2. 使用其 ID 或索引获取任意幻灯片的引用。  
3. 获取带有外观形状边界的引用幻灯片的缩略图图像。  
4. 将缩略图图像保存为任意所需的图像格式。

下面的示例创建了具有用户自定义缩放因子的缩略图。
```cpp
auto bounds = ShapeThumbnailBounds::Appearance;
auto scale = 1; // 沿 X 和 Y 轴的缩放。

auto presentation = MakeObject<Presentation>(u"HelloWorld.pptx");
auto shape = presentation->get_Slide(0)->get_Shape(0);

auto image = shape->GetImage(bounds, scale, scale);
image->Save(u"Shape_thumbnail_Bound_Shape_out.png", ImageFormat::Png);
image->Dispose();

presentation->Dispose();
```


## **FAQ**

**保存形状缩略图时可以使用哪些图像格式？**

[PNG, JPEG, BMP, GIF, TIFF](https://reference.aspose.com/slides/cpp/aspose.slides/imageformat/)，以及其他格式。形状还可以通过将其内容保存为 SVG 来[导出为矢量 SVG](https://reference.aspose.com/slides/cpp/aspose.slides/shape/writeassvg/)。

**在渲染缩略图时，Shape 边界和 Appearance 边界有何区别？**

`Shape` 使用形状的几何区域；`Appearance` 会考虑[视觉效果](/slides/zh/cpp/shape-effect/)(阴影、发光等)。

**如果形状被标记为隐藏，它仍会生成缩略图吗？**

隐藏的形状仍然是模型的一部分，可以渲染；隐藏标记仅影响幻灯片放映的显示，不会阻止生成形状图像。

**是否支持组形状、图表、SmartArt 以及其他复杂对象？**

支持。任何作为[Shape](https://reference.aspose.com/slides/cpp/aspose.slides/shape/)表示的对象（包括[GroupShape](https://reference.aspose.com/slides/cpp/aspose.slides/groupshape/)、[Chart](https://reference.aspose.com/slides/cpp/aspose.slides.charts/chart/)、以及[SmartArt](https://reference.aspose.com/slides/cpp/aspose.slides.smartart/smartart/)）都可以保存为缩略图或 SVG。

**系统安装的字体会影响文本形状缩略图的质量吗？**

会。您应当[提供所需的字体](/slides/zh/cpp/custom-font/)（或[配置字体替代](/slides/zh/cpp/font-substitution/)），以避免出现不希望的回退和文本重排。