Shapes.AddPicture-Methode (Publisher)
Fügt der angegebenen Shapes-Auflistung ein neues Shape-Objekt hinzu, das ein 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 | Der Name der Grafikdatei, die in die Form eingefügt werden soll. Der Pfad kann absolut oder relativ sein. |
| LinkToFile | Erforderlich | MsoTriState | Bestimmt, ob die Grafik mit der Publikation verknüpft oder in sie eingebettet ist. |
| SaveWithDocument | Erforderlich | MsoTriState | Bestimmt, ob die Grafik als separate Datei mit der Publikation gespeichert wird. |
| Left | Erforderlich | Variant | Die Position der linken Begrenzung der Form, die das Bild darstellt. |
| Top | Erforderlich | Variant | Die Position der oberen Begrenzung der Form, die das Bild darstellt. |
| Width | Optional | Variant | The width of the shape representing the picture. Default is -1, meaning that the width of the shape is automatically set based on the object's data. |
| Height | Optional | Variant | The height of the shape representing the picture. Der Standardwert ist -1, was bedeutet, dass die Höhe der Form automatisch basierend auf den Daten des Objekts festgelegt wird. |
Rückgabewert
Form
Bemerkungen
Wenn das Argument SaveWithDocument auf msoTrue festgelegt ist, wird in Microsoft Publisher eine neue Kopie der durch das Argument FileName angegebenen Grafikdatei im gleichen Verzeichnis wie die Publikation gespeichert.
Die Argumente LinkToFile und SaveWithDocument können nicht denselben Wert aufweisen, andernfalls tritt ein Fehler auf. Wenn ein Argument auf msoTrue festgelegt ist, muss die andere MsoFalse.
Für die Argumente Left, Top, Width und Height werden numerische Werte in Punkt ausgewertet. Zeichenfolgen können sich in beliebigen Einheiten befinden, die von Publisher unterstützt werden (z. B. "2,5 zoll").
Der LinkToFile-Parameter kann eine der msoTriState-Konstanten sein, die in der Microsoft Office-Typbibliothek deklariert und in der folgenden Tabelle angezeigt werden.
| Konstante | Beschreibung |
|---|---|
| msoFalse | Die Grafik soll in die Publikation eingebettet werden. |
| msoTrue | Die Grafik soll mit der Publikation verknüpft werden. |
Beispiel
Im folgenden Beispiel wird der aktiven Publikation basierend auf einer vorhandenen Datei ein Bild hinzugefügt. Das Bild in der Publikation ist mit einer Kopie der Originaldatei verknüpft. Beachten Sie, dass PathToFile durch einen gültigen Dateipfad ersetzt werden muss, damit dieses Beispiel funktioniert.
Dim shpPicture As Shape
Set shpPicture = ActiveDocument.Pages(1).Shapes.AddPicture _
(FileName:="PathToFile", _
LinkToFile:=msoTrue, _
SaveWithDocument:=msoFalse
Left:=72, Top:=72)
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.