WPS 加载项开发 > 表格 API 参考 > OLEObjects > 方法 > OLEObjects.Add 方法
向工作表中添加新的 OLE 对象。

语法

表达式.Add(ClassType, FileName, Link, DisplayAsIcon, IconFileName, IconIndex, IconLabel, Left, Top, Width, Height)

表达式   一个代表 OLEObjects 对象的变量。

参数

名称 必选/可选 数据类型 说明
ClassType 可选 Variant (必须指定 ClassTypeFileName)。一个字符串,包含要创建的对象的程序标识符。如果指定了 ClassType 参数,则忽略 FileNameLink
Height 可选 Variant (必须指定 ClassTypeFileName)。一个字符串,指定用于创建 OLE 对象的文件。
Link 可选 Variant 如果为 True,则让基于 FileName 的新 OLE 对象链接到该文件。如果该对象未链接到文件,则该对象被创建为文件副本。默认值是 False
DisplayAsIcon 可选 Variant 如果为 True,则以图标或正常图片方式显示新的 OLE 对象。如果该参数设置为 True,则可以使用 IconFileNameIconIndex 来指定图标。
IconFileName 可选 Variant 一个字符串,指定要显示的图标所在的文件。仅当 DisplayAsIconTrue 时,才使用该参数。如果不指定该参数,或文件中不包含图标,则使用 OLE 类的默认图标。
IconIndex 可选 Variant 图标文件中包含的图标数目。仅当 DisplayAsIcon 参数为 True 并且 IconFileName 参数引用包含图标的有效文件时,才使用该参数。如果由 IconFileName 参数指定的文件中不存在具有指定索引号的图标,则使用该文件中的第一个图标。
IconLabel 可选 Variant 一个字符串,指定在图标下方显示一个标签。仅当 DisplayAsIconTrue 时,才使用该参数。如果省略该参数,或者该参数为空字符串 (""),则不显示任何标题。
Left 可选 Variant 以磅为单位给出新对象的初始坐标,该坐标是相对于工作表上单元格 A1 的左上角或图表的左上角的坐标。
Width 可选 Variant 以磅为单位给出新对象的初始大小。

返回值
一个 OLEObject 对象,它代表新的 OLE 对象。

示例

此示例在工作表 Sheet1 中新建一个 WPS OLE 对象。

示例代码
ActiveWorkbook.Worksheets.Item("Sheet1").OLEObjects().Add("WPS.Document")

此示例为第一张工作表添加一个命令按钮。

示例代码
Worksheets.Item(1).OLEObjects().Add("Forms.CommandButton.1", false, false, 40, 40, 150, 10)


请参阅