PowerPoint) (Shape.Export 方法

使用指定的图形筛选器导出形状,并将导出的文件保存在指定的文件名下。

语法

表达式。导出 (参数)

expression 一个代表 Shape 对象的变量。

参数

名称 必需/可选 数据类型 说明
PathName 必需 String 将导出并保存到磁盘的文件的名称。 可以包括完整路径;如果不包括完整路径,Microsoft PowerPoint 就会在当前文件夹中创建一个文件。 以磅为单位指定阴影水平移动的距离。 正值使阴影向右移动,负值使阴影向左移动。
筛选 必需 PpShapeFormat 用于创建导出图像文件的图形滤镜。
ScaleWidth 可选 长型 图像的宽度(以磅为单位)。 默认值为幻灯片宽度。
ScaleHeight 可选 长型 图像的高度(以磅为单位)。 默认值为幻灯片高度。
ExportMode 可选 ppExportMode 在创建导出的图像文件时使用的缩放方法。 如果未指定,尺寸将相对于幻灯片的大小缩放。

枚举

PowerPoint) (PpShapeFormat 枚举

名称 值 说明
ppShapeFormatBMP 3 位图
ppShapeFormatEMF 5 增强的元文件
ppShapeFormatGIF 0 静态 GIF
ppShapeFormatJPG 1 压缩的 JPG
ppShapeFormatPNG 2 无损 PNG
ppShapeFormatSVG 6 可缩放矢量图形
ppShapeFormatWMF 4 Windows Metafile

PowerPoint) (ExportMode 枚举

名称 值 说明
ppClipRelativeToSlide 2 保留以备今后使用
ppRelativeToSlide 1 相对于幻灯片尺寸缩放图像
ppScaleToFit 3 保留以备今后使用
ppScaleXY 4 保留以备今后使用

备注

PowerPoint 使用指定的图形筛选器保存每个单独的形状。 导出并保存到磁盘的形状的名称由 PathName 参数确定,该参数应包括所选图形筛选器的相应文件扩展名。

ScaleWidth 和 ScaleHeight 参数用于相对于幻灯片尺寸缩放导出的图像大小。 例如,如果在幻灯片上创建了一个纯 1 英寸正方形形状,则它在对象模型中将测量为 72x72 磅。 在不使用任何缩放因子的情况下导出时,将应用默认缩放 1:1,PowerPoint 将使用 96DPI 创建 96x96 像素图像。 如果按下面的示例 2 所示使用 2 倍的缩放因子,则导出的图像将为 192x192 像素。

如果幻灯片和/或形状未完全下载,则此方法失败并出现错误。 有关部分文档的更多信息,请参阅 使用部分文档。

从 macOS 上的 PowerPoint 导出时,必须在 Office 沙盒文件夹或 PowerPoint 沙盒文件夹中创建文件:

/Users/[username]/Library/Group Containers/UBF8T346G9.Office /Users/[username]/Library/Containers/com.microsoft.Powerpoint/Data

如果尝试使用这些沙盒位置之外的路径,就会引发自动化错误。

可用性

SVG 筛选器在 Windows 版本 2302 及更高版本上可用。

导出方法在 macOS 版本 16.82 及更高版本上可用。

示例

以下示例将活动演示文稿中的所有 SVG 形状作为 SVG 文件导出到用户的“图片”文件夹。 默认 PpRelativeToSlide 值用于 ExportMode 参数,这意味着导出的图像将


For Each oSld In ActivePresentation.Slides
    For Each oShp In oSld.Shapes
        If oShp.Type = msoGraphic Then
            FileName = oShp.Name & ".svg"
            PathToFolder = Environ("USERPROFILE") & "\Pictures\"
            oShp.Export PathToFolder & FileName, ppShapeFormatSVG
        End If
    Next
Next 

以下示例使用缩放功能以相对于幻灯片的大小导出所选对象。 在这种情况下,幻灯片是标准的 16:9 大小,即 960x540 磅。 将以幻灯片上其大小的两倍创建导出的图像。


PathToFile = Environ("USERPROFILE") & "\Pictures\export.png"

With ActiveWindow.Selection.ShapeRange(1)
        .Export PathToFile, ppShapeFormatPNG, 1920, 1080, ppRelativeToSlide
End With

另请参阅

形状对象

PageSetup.SlideHeight

PageSetup.SlideWidth

处理部分文档

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。