Shapes.AddPicture-Methode (Excel)
Erstellt ein Bild aus einer vorhandenen Datei. Gibt ein Shape-Objekt zurück, das das neue Bild darstellt.
Syntax
Ausdruck. AddPicture (FileName, LinkToFile, SaveWithDocument, Left, Top, Width, Height)
expression Eine Variable, die ein Shapes-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| FileName | Erforderlich | String | Die Datei, aus der das Bild erstellt werden soll. |
| LinkToFile | Erforderlich | MsoTriState | Die Datei, zu der eine Verknüpfung hergestellt werden soll. Verwenden Sie msoFalse , um das Bild zu einer unabhängigen Kopie der Datei zu machen. Verwenden Sie msoTrue , um das Bild mit der Datei zu verknüpfen, aus der es erstellt wurde. |
| SaveWithDocument | Erforderlich | MsoTriState | Zum Speichern des Bilds mit dem Dokument. Verwenden Sie msoFalse , um nur die Linkinformationen im Dokument zu speichern. Verwenden Sie msoTrue , um das verknüpfte Bild mit dem Dokument zu speichern, in das es eingefügt wird. Dieses Argument muss auf msoTrue gesetzt sein, wenn LinkToFile auf msoFalse gesetzt ist. |
| Left | Erforderlich | Single | Die Position (in Punkt) der oberen linken Ecke des Bilds relativ zur linken oberen Ecke des Dokuments. |
| Top | Erforderlich | Single | Die Position (in Punkten) der oberen linken Ecke des Bilds relativ zum oberen Rand des Dokuments. |
| Width | Erforderlich | Single | Die Breite des Bilds in Punkten (Geben Sie „-1" ein, um die Breite der vorhandenen Datei beizubehalten). |
| Height | Erforderlich | Single | Die Höhe des Bilds in Punkten (Geben Sie „-1“ ein, um die Höhe der vorhandenen Datei beizubehalten). |
Rückgabewert
Form
Beispiel
In diesem Beispiel wird myDocument ein Bild hinzugefügt, das aus der Datei Music.bmp erstellt wurde. Das eingefügte Bild ist mit der Datei verknüpft, aus der es erstellt wurde, und wird mit myDocument gespeichert.
Set myDocument = Worksheets(1)
myDocument.Shapes.AddPicture _
"c:\microsoft office\clipart\music.bmp", _
True, True, 100, 100, 70, 70
Support und Feedback
Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.