Shape.Export-Methode (PowerPoint)

Exportiert eine Form unter Verwendung des angegebenen Grafikfilters und speichert die exportierte Datei unter dem angegebenen Dateinamen.

Syntax

Ausdruck verwendet werden. Export(Parameters)

expression Eine Variable, die ein Shape-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
PathName Erforderlich Zeichenfolge Der Name der Datei, die exportiert und auf dem Datenträger gespeichert werden soll. Sie können einen vollständigen Pfad einschließen; Andernfalls erstellt Microsoft PowerPoint eine Datei im aktuellen Ordner. Gibt an, wie weit der Offset des Schattens horizontal verschoben werden soll (in Punkten). Ein positiver Wert verschiebt den Schatten nach rechts, ein negativer Wert verschiebt ihn nach links.
Filter Erforderlich PpShapeFormat Der Grafikfilter, der bei der Erstellung der exportierten Bilddatei verwendet werden soll.
ScaleWidth Optional Long Die Breite des Bilds in Punkten. Der Standardwert ist die Folienbreite.
ScaleHeight Optional Long Die Höhe des Bilds in Punkten. Der Standardwert ist die Folienhöhe.
ExportMode Optional ppExportMode Die Skalierungsmethode, die bei der Erstellung der exportierten Bilddatei verwendet wird. Wenn nicht angegeben, werden die Abmessungen relativ zur Größe der Folie skaliert.

Aufzählungen

PpShapeFormat-Enumeration (PowerPoint)

Name Wert Beschreibung
ppShapeFormatBMP 3 Bitmap
ppShapeFormatEMF 5 Erweiterte Metadatei
ppShapeFormatGIF 0 Statische GIF-Datei
ppShapeFormatJPG 1 Komprimiertes JPG
ppShapeFormatPNG 2 Verlustfreies PNG
ppShapeFormatSVG 6 Skalierbare Vektorgrafik
ppShapeFormatWMF 4 Windows-Metadatei

ExportMode-Enumeration (PowerPoint)

Name Wert Beschreibung
ppClipRelativeToSlide 2 Reserviert für zukünftige Verwendung
ppRelativeToSlide 1 Skaliert das Bild relativ zu den Abmessungen der Folie.
ppScaleToFit 3 Reserviert für zukünftige Verwendung
ppScaleXY 4 Reserviert für zukünftige Verwendung

Hinweise

PowerPoint verwendet den angegebenen Grafikfilter, um jede einzelne Form zu speichern. Die Namen der exportierten und auf dem Datenträger gespeicherten Shapes werden durch das PathName-Argument bestimmt, das die entsprechende Dateierweiterung für den ausgewählten Grafikfilter enthalten sollte.

Die Parameter "ScaleWidth " und "ScaleHeight" werden verwendet, um die exportierte Bildgröße relativ zu den Abmessungen der Folie zu skalieren. Wenn Sie zum Beispiel auf einer Folie eine einfache quadratische Form von 1 Zoll erstellen, hat sie im Objektmodell eine Größe von 72 x 72 Punkten. Beim Export ohne Verwendung eines Skalierungsfaktors wird der Standardmaßstab 1:1 angewendet, und PowerPoint verwendet 96 DPI, um ein Bild mit 96 x 96 Pixeln zu erstellen. Wenn ein Skalierungsfaktor von 2x verwendet wird, wie in Beispiel 2 unten gezeigt, hat das exportierte Bild eine Größe von 192x192 Pixeln.

Wenn die Folie und/oder das Shape nicht vollständig heruntergeladen wurde, schlägt diese Methode fehl, und es tritt ein Fehler auf. Weitere Informationen zu den Teildokumenten finden Sie unter Arbeiten mit Teildokumenten.

Beim Exportieren aus PowerPoint unter macOS müssen die Dateien entweder im Office-Sandbox-Ordner oder im PowerPoint-Sandbox-Ordner erstellt werden:

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

Wenn Sie versuchen, einen Pfad außerhalb dieser Sandbox-Speicherorte zu verwenden, wird ein Automatisierungsfehler ausgelöst.

Verfügbarkeit

Der SVG-Filter ist ab Windows, Version 2302, verfügbar.

Die Exportmethode ist unter macOS ab Version 16.82 verfügbar.

Beispiel

Im folgenden Beispiel werden alle SVG-Formen in der aktiven Präsentation als SVG-Dateien in den Ordner "Bilder" des Benutzers exportiert. Der Standardwert PpRelativeToSlide wird für den ExportMode-Parameter verwendet, was bedeutet, dass das exportierte Bild


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 

Im folgenden Beispiel wird das Skalierungsfeature verwendet, um das ausgewählte Objekt mit einer Größe relativ zur Folie zu exportieren. In diesem Fall hat die Folie ein Standardformat 16:9, was 960 x 540 Punkten entspricht. Das exportierte Bild wird mit der doppelten Größe auf der Folie erstellt.


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

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

Siehe auch

Shape-Objekt

PageSetup.SlideHeight

PageSetup.SlideWidth

Arbeiten mit Teildokumenten

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.