Méthode Shapes.AddPicture (Excel)

Cette méthode crée une image à partir d’un fichier existant. Renvoie un objet Shape qui représente la nouvelle image.

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 Fichier à partir duquel l’image doit être créée.
LinkToFile Obligatoire MsoTriState Fichier à lier. Utilisez msoFalse pour faire de l’image une copie indépendante du fichier. Utilisez msoTrue pour lier l’image au fichier à partir duquel elle a été créée.
SaveWithDocument Obligatoire MsoTriState Pour enregistrer l'image avec le document. Utilisez msoFalse pour stocker uniquement les informations de lien dans le document. Utilisez msoTrue pour enregistrer l’image liée avec le document dans lequel elle est insérée. Cet argument doit être msoTrue si LinkToFile est msoFalse.
Left Obligatoire Unique Position (en points) du coin supérieur gauche de l’image par rapport au coin supérieur gauche du document.
Top Obligatoire Single Position (exprimée en points) du coin supérieur gauche de l'image par rapport au haut du document.
Width Obligatoire Single Largeur de l'image, exprimée en points (entrez -1 pour conserver la largeur du fichier existant).
Height Obligatoire Single Hauteur de l’image, exprimée en points (entrez -1 pour conserver la hauteur du fichier existant).

Valeur renvoyée

Forme

Exemple

Cet exemple montre comment ajouter une image créée à partir du fichier Music.bmp à myDocument. L’image insérée est liée au fichier à partir duquel elle a été créée et est enregistrée avec myDocument.

Set myDocument = Worksheets(1) 
myDocument.Shapes.AddPicture _ 
    "c:\microsoft office\clipart\music.bmp", _ 
    True, True, 100, 100, 70, 70

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.