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.