OLEObjects.Add Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Adds a new OLE object to a sheet. Returns an OLEObject object.
public Microsoft.Office.Interop.Excel.OLEObject Add (object ClassType, object Filename, object Link, object DisplayAsIcon, object IconFileName, object IconIndex, object IconLabel, object Left, object Top, object Width, object Height);
Public Function Add (Optional ClassType As Object, Optional Filename As Object, Optional Link As Object, Optional DisplayAsIcon As Object, Optional IconFileName As Object, Optional IconIndex As Object, Optional IconLabel As Object, Optional Left As Object, Optional Top As Object, Optional Width As Object, Optional Height As Object) As OLEObject
Parameters
- ClassType
- Object
Optional Object. (You must specify either ClassType
or FileName
.) A string that contains the programmatic identifier for the object to be created. If ClassType
is specified, FileName
and Link
are ignored.
- Filename
- Object
Optional Object. (You must specify either ClassType
or FileName
.) A string that specifies the file to be used to create the OLE object.
- Link
- Object
Optional Object. True to have the new OLE object based on FileName
be linked to that file. If the object isn't linked, the object is created as a copy of the file. The default value is False.
- DisplayAsIcon
- Object
Optional Object. True to display the new OLE object either as an icon or as its regular picture. If this argument is True, IconFileName
and IconIndex
can be used to specify an icon.
- IconFileName
- Object
Optional Object. A string that specifies the file that contains the icon to be displayed. This argument is used only if DisplayAsIcon
is True. If this argument isn't specified or the file contains no icons, the default icon for the OLE class is used
- IconIndex
- Object
Optional Object. The number of the icon in the icon file. This is used only if DisplayAsIcon
is True and IconFileName
refers to a valid file that contains icons. If an icon with the given index number doesn't exist in the file specified by IconFileName
, the first icon in the file is used.
- IconLabel
- Object
Optional Object. A string that specifies a label to display beneath the icon. This is used only if DisplayAsIcon
is True. If this argument is omitted or is an empty string (""), no caption is displayed.
- Left
- Object
Optional Object. The initial coordinates of the new object in points, relative to the upper-left corner of cell A1 on a worksheet, or to the upper-left corner of a chart.
- Top
- Object
Optional Object. The initial coordinates of the new object in points, relative to the upper-left corner of cell A1 on a worksheet, or to the upper-left corner of a chart.
- Width
- Object
Optional Object. The initial size of the new object in points.
- Height
- Object
Optional Object. The initial size of the new object, in points.