Shapes.AddPicture-Methode (Excel)

  • Artikel

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.