Метод Shape.Export (PowerPoint)

Статья
01/17/2024

Экспортирует фигуру с помощью указанного графического фильтра и сохраняет экспортируемый файл под указанным именем файла.

Синтаксис

expression. Export(Parameters)

выражение Переменная, представляющая объект Фигура.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
PathName	Обязательный	String	Имя файла для экспорта и сохранения на диск. Можно включить полный путь; В противном случае Microsoft PowerPoint создает файл в текущей папке. Указывает, как далеко смещение тени должно перемещаться по горизонтали в точках. Положительное значение перемещает тень вправо; отрицательное значение перемещает его влево.
Фильтр	Обязательный	PpShapeFormat	Графический фильтр, используемый при создании экспортированного файла изображения.
ScaleWidth	Необязательный	Long	Ширина изображения в точках. По умолчанию используется ширина слайда.
ScaleHeight	Необязательный	Long	Высота изображения в точках. По умолчанию используется высота слайда.
ExportMode	Необязательный	ppExportMode	Метод масштабирования, используемый при создании экспортированного файла образа. Если этот параметр не указан, размеры будут масштабироваться относительно размера слайда.

Перечисления

Перечисление PpShapeFormat (PowerPoint)

Имя	Значение	Описание
ppShapeFormatBMP	3	Точечный рисунок
ppShapeFormatEMF	5	Расширенный метафайл
ppShapeFormatGIF	0	Статический GIF
ppShapeFormatJPG	1	Сжатый ФОРМАТ JPG
ppShapeFormatPNG	2	PNG без потерь
ppShapeFormatSVG	6	Масштабируемая векторная графика
ppShapeFormatWMF	4	Метафайл Windows

Перечисление ExportMode (PowerPoint)

Имя	Значение	Описание
ppClipRelativeToSlide	2	Зарезервировано для последующего использования.
ppRelativeToSlide	1	Масштабирует изображение относительно размеров слайда
ppScaleToFit	3	Зарезервировано для последующего использования.
ppScaleXY	4	Зарезервировано для последующего использования.

Замечания

PowerPoint использует указанный графический фильтр для сохранения каждой отдельной фигуры. Имена фигур, экспортированных и сохраненных на диск, определяются аргументом PathName, который должен содержать соответствующее расширение файла для выбранного графического фильтра.

Параметры ScaleWidth и ScaleHeight используются для масштабирования экспортированного размера изображения относительно размеров слайда. Например, если на слайде создается простая квадратная фигура 1", она будет измеряться как 72 x 72 точки в объектной модели. При экспорте без использования коэффициента масштабирования применяется масштаб по умолчанию 1:1, и PowerPoint будет использовать 96DPI для создания изображения 96x96 пикселей. Если используется коэффициент масштабирования 2x, как показано в примере 2 ниже, экспортируемое изображение будет иметь размер 192 x 192 пикселя.

Если слайд и (или) фигура загружены не полностью, этот метод завершается сбоем и возникает ошибка. Дополнительные сведения о частичных документах см. в разделе Работа с частичными документами.

При экспорте из PowerPoint в macOS файлы должны создаваться либо в папке песочницы Office, либо в папке песочницы PowerPoint:

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

При попытке использовать путь за пределами этих расположений песочницы возникает ошибка автоматизации.

Доступность

Фильтр SVG доступен в Windows версии 2302 и более поздних.

Метод Export доступен в 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, который составляет 960 x 540 точек. Экспортируемая изображение создается в два раза больше, чем его размер на слайде.


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

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

См. также

Объект Shape

PageSetup.SlideHeight

PageSetup.SlideWidth

Работа с частичными документами

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.

Поделиться через