Méthode Shape.Export (PowerPoint)

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

Syntaxe

expression. Exporter (paramètres)

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 vous ne le faites pas, 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 lors de la création du fichier image exporté.
ScaleWidth Facultatif Entier long Largeur de l’image en points. La valeur par défaut est la largeur de la diapositive.
ScaleHeight Facultatif Entier long Hauteur de l’image en points. La valeur par défaut est la hauteur de la diapositive.
Mode d’exportation Facultatif ppExportMode Méthode de mise à l’échelle utilisée lors de la création du fichier image exporté. Si cela n’est pas spécifié, les dimensions sont mises à l’échelle en fonction de la taille de la diapositive.

Énumérations

Énumération PpShapeFormat (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

Énumération ExportMode (PowerPoint)

Nom Valeur Description
ppClipRelativeToSlide 2 Réservé à une utilisation ultérieure.
ppRelativeToSlide 1 Met l’image à l’échelle en fonction des 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 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 permettent de mettre à l’échelle la taille de l’image exportée par rapport aux dimensions de la diapositive. Par exemple, si une forme carrée ordinaire de 1" est créée sur une diapositive, elle mesurera 72 x 72 points dans le modèle objet. Lors de l’exportation sans utiliser de facteur d’échelle, l’échelle par défaut de 1:1 est appliquée et PowerPoint utilise 96 PPP pour créer une image de 96 x 96 pixels. Si un facteur d’échelle de 2x est utilisé comme illustré 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, voir 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 PowerPoint :

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

Si vous tentez d’utiliser un chemin d’accès en dehors de ces emplacements de bac à sable, une erreur d’automatisation est générée.

Disponibilité

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

La méthode d’exportation 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 dans le dossier Images de l’utilisateur. La valeur par défaut PpRelativeToSlide 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 fonction d’échelle pour exporter l’objet sélectionné à une taille relative à celle de la diapositive. Dans ce cas, la diapositive est au format standard 16:9, c’est-à-dire 960 x 540 points. L’image exportée est créée à deux fois la taille 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.