Shape.Export, méthode (PowerPoint)

Article
01/17/2024

Exporte une forme à l’aide du filtre graphique spécifié et enregistre le fichier exporté sous le nom de fichier spécifié.

Syntaxe

expression. Export(Parameters)

expression Une variable qui représente uneForme d’objet.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
PathName	Obligatoire	String	Nom du fichier à exporter et à enregistrer sur le disque. Vous pouvez inclure un chemin d’accès complet ; Si ce n’est pas le cas, Microsoft PowerPoint crée un fichier dans le dossier actif. Spécifie en points la distance de décalage horizontal de l'ombre. Spécifiez une valeur positive pour décaler l'ombre vers la droite, ou inversement, une valeur négative, pour la décaler vers la gauche.
Filtre	Obligatoire	PpShapeFormat	Filtre graphique à utiliser dans la création du fichier image exporté.
ScaleWidth	Facultatif	Entier long	Largeur de l’image en points. La largeur de la diapositive est la valeur par défaut.
ScaleHeight	Facultatif	Entier long	Hauteur de l’image en points. La valeur par défaut est la hauteur de la diapositive.
ExportMode	Facultatif	ppExportMode	Méthode de mise à l’échelle utilisée dans la création du fichier image exporté. Si elles ne sont pas spécifiées, les dimensions sont mises à l’échelle par rapport à la taille de la diapositive.

Énumérations

PpShapeFormat, énumération (PowerPoint)

Nom	Valeur	Description
ppShapeFormatBMP	3	Image bitmap
ppShapeFormatEMF	5	Métafichier amélioré
ppShapeFormatGIF	0	GIF statique
ppShapeFormatJPG	1	JPG compressé
ppShapeFormatPNG	2	PNG sans perte
ppShapeFormatSVG	6	Graphique vectoriel évolutif
ppShapeFormatWMF	4	Métafichier Windows

ExportMode, énumération (PowerPoint)

Nom	Valeur	Description
ppClipRelativeToSlide	2	Réservé à une utilisation ultérieure.
ppRelativeToSlide	1	Met à l’échelle l’image par rapport aux dimensions de la diapositive
ppScaleToFit	3	Réservé à une utilisation ultérieure.
ppScaleXY	4	Réservé à une utilisation ultérieure.

Remarques

PowerPoint utilise le filtre graphique spécifié pour enregistrer chaque forme individuelle. Les noms des formes exportées et enregistrées sur le disque sont déterminés par l’argument PathName qui doit inclure l’extension de fichier correspondante pour le filtre graphique choisi.

Les paramètres ScaleWidth et ScaleHeight sont utilisés pour mettre à l’échelle la taille de l’image exportée par rapport aux dimensions de la diapositive. Par exemple, si une forme carrée simple de 1 pouce est créée sur une diapositive, elle mesurera 72 x 72 points dans le modèle objet. En cas d’exportation sans facteur d’échelle, l’échelle par défaut de 1 :1 est appliquée et PowerPoint utilise 96DPI pour créer une image de 96 x 96 pixels. Si un facteur d’échelle de 2x est utilisé comme indiqué dans l’exemple 2 ci-dessous, l’image exportée sera de 192 x 192 pixels.

Si la diapositive et/ou la forme ne sont pas entièrement téléchargées, cette méthode échoue et une erreur se produit. Pour plus d’informations sur les documents partiels, consultez Utiliser des documents partiels.

Lors de l’exportation à partir de PowerPoint sur macOS, les fichiers doivent être créés dans le dossier bac à sable Office ou dans le dossier bac à sable PowerPoint :

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

Si vous essayez d’utiliser un chemin en dehors de ces emplacements de bac à sable et que l’erreur d’automatisation est générée.

Disponibilité

Le filtre SVG est disponible sur Windows version 2302 et ultérieure.

La méthode Exporter est disponible sur macOS sur les versions 16.82 et ultérieures.

Exemple

L’exemple suivant exporte toutes les formes SVG de la présentation active sous forme de fichiers SVG vers le dossier Images de l’utilisateur. La valeur ppRelativeToSlide par défaut est utilisée pour le paramètre ExportMode , ce qui signifie que l’image exportée sera


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

L’exemple suivant utilise la fonctionnalité de mise à l’échelle pour exporter l’objet sélectionné à une taille relative à la diapositive. Dans ce cas, la diapositive est d’une taille standard 16 :9 qui est de 960 x 540 points. L’image exportée est créée au double de sa taille sur la diapositive.


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

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

Voir aussi

Shape, objet

PageSetup.SlideHeight

PageSetup.SlideWidth

Utiliser des documents partiels

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.

Partager via