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.