Freigeben über


OLEObjects.Add-Methode (Excel)

Fügt einem Blatt ein neues OLE-Objekt hinzu.

Syntax

Ausdruck. Hinzufügen (ClassType, FileName, Link, DisplayAsIcon, IconFileName, IconIndex, IconLabel, Left, Top, Width, Height)

Ausdruck Eine Variable, die ein OLEObjects-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
ClassType Optional Variant Sie müssen entweder ClassType oder FileName angeben. Eine Zeichenfolge mit dem programmtechnischen Bezeichner für das zu erstellende Objekt. Wenn ClassType angegeben ist, werden FileName und Link ignoriert.
FileName Optional Variant Sie müssen entweder ClassType oder FileName angeben. Eine Zeichenfolge, die die Datei angibt, mit der das OLE-Objekt erstellt werden soll.
Link Optional Variant Mit True wird das neue auf FileName basierende OLE-Objekt mit der Datei verknüpft. Wenn es nicht verknüpft wird, wird das Objekt als Kopie der Datei erstellt. Der Standardwert ist False.
DisplayAsIcon Optional Variant Mit True wird das neue OLE-Objekt als Symbol oder in seiner normalen Bilddarstellung angezeigt. Wenn dieses Argument den Wert True aufweist, kann mithilfe von IconFileName und IconIndex ein Symbol angegeben werden.
IconFileName Optional Variant Eine Zeichenfolge, mit der die Datei angegeben wird, die das anzuzeigende Symbol enthält. Dieses Argument wird nur verwendet, wenn DisplayAsIconauf True festgelegt ist. Wird dieses Argument nicht angegeben oder enthält die Datei keine Symbole, wird das Standardsymbol für die OLE-Klasse verwendet.
IconIndex Optional Variant Die Nummer des Symbols in der Symboldatei. Dies wird nur verwendet, wenn DisplayAsIconauf True festgelegt ist und IconFileName auf eine gültige Datei verweist, die Symbole enthält. Wenn in der durch IconFileName angegebenen Datei kein Symbol mit dieser Indexnummer vorhanden ist, wird das erste Symbol in der Datei verwendet.
IconLabel Optional Variant Eine Zeichenfolge, die eine unter dem Symbol anzuzeigende Beschriftung angibt. Dies wird nur verwendet, wenn DisplayAsIconauf True festgelegt ist. Wenn dieses Argument nicht angegeben wird oder die Zeichenfolge leer ("") ist, wird keine Beschriftung angezeigt.
Left Optional Variant Die Anfangskoordinaten des neuen Objekts in Punkt, relativ zur linken oberen Ecke der Zelle A1 auf einem Arbeitsblatt oder zur linken oberen Ecke eines Diagramms.
Top Optional Variant Die Anfangskoordinaten des neuen Objekts in Punkt, relativ zum Anfang von Zeile 1 auf einem Arbeitsblatt oder zum oberen Rand des Diagrammbereichs in einem Diagramm.
Width Optional Variant Die Anfangsbreite des neuen Objekts in Punkten.
Height Optional Variant Die Anfangshöhe des neuen Objekts in Punkten.

Rückgabewert

Ein OLEObject-Objekt , das das neue OLE-Objekt darstellt.

Beispiel

In diesem Beispiel wird ein neues Microsoft Word OLE-Objekt auf Sheet1 erstellt.

ActiveWorkbook.Worksheets("Sheet1").OLEObjects.Add _ 
 ClassType:="Word.Document"

In diesem Beispiel wird dem ersten Blatt eine Befehlsschaltfläche hinzugefügt.

Worksheets(1).OLEObjects.Add ClassType:="Forms.CommandButton.1", _ 
 Link:=False, DisplayAsIcon:=False, Left:=40, Top:=40, _ 
 Width:=150, Height:=10

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.