Teilen über


Shape.Export-Methode (PowerPoint)

Exportiert ein Shape mit dem angegebenen Grafikfilter und speichert die exportierte Datei unter dem angegebenen Dateinamen.

Syntax

Ausdruck. Export(Parameter)

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 Punkt. Der Standardwert ist die Folienbreite.
ScaleHeight Optional Long Die Höhe des Bilds in Punkt. 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 Dimensionen relativ zur Größe der Folie skaliert.

Aufzählungen

PpShapeFormat-Enumeration (PowerPoint)

Name Wert Beschreibung
ppShapeFormatBMP 3 Bitmap
ppShapeFormatEMF 5 Erweiterte Metadatei
ppShapeFormatGIF 0 Statisches GIF
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 mit dem PathName-Argument bestimmt, das die entsprechende Dateierweiterung für den ausgewählten Grafikfilter enthalten soll.

Die Parameter ScaleWidth und ScaleHeight werden verwendet, um die exportierte Bildgröße relativ zu den Abmessungen der Folie zu skalieren. Wenn beispielsweise eine einfache quadratische Form mit 1 Zoll auf einer Folie erstellt wird, wird sie im Objektmodell als 72 x 72 Punkte gemessen. Beim Export ohne Verwendung eines Skalierungsfaktors wird die Standardskala 1:1 angewendet, und PowerPoint verwendet 96DPI, um ein Bild mit 96 x 96 Pixeln zu erstellen. Wenn ein Skalierungsfaktor von 2x verwendet wird, wie in Beispiel 2 unten gezeigt, beträgt das exportierte Bild 192 x 192 Pixel.

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

Beim Exportieren aus PowerPoint unter macOS müssen die Dateien entweder im Office-Sandboxordner oder im PowerPoint-Sandboxordner 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 Sandboxspeicherorte zu verwenden, wird ein Automatisierungsfehler ausgelöst.

Verfügbarkeit

Der SVG-Filter ist unter Windows Version 2302 und höher verfügbar.

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

Beispiel

Im folgenden Beispiel werden alle SVG-Shapes in der aktiven Präsentation als SVG-Dateien in den Ordner Bilder des Benutzers exportiert. Der PpRelativeToSlide-Standardwert 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 relativ zur Folie zu exportieren. In diesem Fall hat die Folie eine Standardgröße von 16:9, die 960 x 540 Punkte beträgt. Das exportierte Bild wird mit der doppelten Größe der 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.