Shapes.AddPicture, méthode (Publisher)

Article
04/07/2023

Ajoute un nouvel objet Shape représentant une image à la collection Shapes spécifiée.

Syntaxe

expression. AddPicture (FileName, LinkToFile, SaveWithDocument, Left, Top, Width, Height)

expression Variable qui représente un objet Shapes.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
FileName	Obligatoire	String	Nom du fichier image à insérer dans la forme. Le chemin d'accès peut être absolu ou relatif.
LinkToFile	Obligatoire	MsoTriState	Détermine si l'image est liée ou incorporée à la composition.
SaveWithDocument	Obligatoire	MsoTriState	Détermine si l'image est enregistrée en tant que fichier séparé avec la composition.
Left	Obligatoire	Variant	Position du bord gauche de la forme représentant l'image.
Top	Obligatoire	Variant	Position du bord supérieur de la forme représentant l'image.
Width	Facultatif	Variant	Largeur de la forme représentant l'image. La valeur par défaut est -1, ce qui signifie que la largeur de la forme est automatiquement définie en fonction des données de l'objet.
Height	Facultatif	Variant	Hauteur de la forme représentant l'image. La valeur par défaut est -1, ce qui signifie que la hauteur de la forme est automatiquement définie en fonction des données de l’objet.

Valeur renvoyée

Shape

Remarques

Si la valeur de l’argument SaveWithDocument est msoTrue, Microsoft Publisher enregistre une nouvelle copie du fichier image spécifié par l’argument FileName dans le même répertoire que la composition.

Les arguments LinkToFile et SaveWithDocument ne peuvent pas avoir la même valeur, sinon une erreur se produit. Si des arguments sont msoTrue, l'autre doit être msoFalse.

Pour les arguments Left, Top, Width et Height , les valeurs numériques sont évaluées en points ; les chaînes peuvent être dans n’importe quelle unité prise en charge par Publisher (par exemple, « 2,5 pouces »).

Le paramètre LinkToFile peut être l’une des constantes MsoTriState déclarées dans la bibliothèque de type Microsoft Office et affichées dans le tableau suivant.

Constante	Description
msoFaux	L'image doit être incorporée dans la composition.
msoVrai	L'image doit être liée à la composition.

Exemple

L’exemple suivant ajoute une image basée sur un fichier existant à la composition active . l’image de la composition est liée à une copie du fichier d’origine. Notez que doit être remplacé par un chemin de fichier valide pour que PathToFile cet exemple fonctionne.

Dim shpPicture As Shape 
 
Set shpPicture = ActiveDocument.Pages(1).Shapes.AddPicture _ 
 (FileName:="PathToFile", _ 
 LinkToFile:=msoTrue, _ 
 SaveWithDocument:=msoFalse 
 Left:=72, Top:=72)

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