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.