前页 后页

收藏类

集合是自动化接口中所有元素使用的主要集合类。它包含用于遍历集合,刷新集合以及从集合中删除项目的方法。

重要的是要意识到,当调用“ AddNew”功能时,该项目不会自动添加到当前集合中。典型步骤为:

  • 致电AddNew添加新项目
  • 根据需要修改项目
  • 在项目上调用更新以将其保存到数据库
  • 在集合上调用刷新以将其包括在当前集合中
删除是一样的;在调用Refresh之前,集合仍包含对已删除项目的引用,不应调用该引用。

每种方法都可用于遍历集合中支持这种构造类型的语言。

集合属性

属性

备注

也可以看看

计数

注意:只读

此列表引用的对象数。

对象类型

对象类型

注意:只读

区分通过Dispatch接口引用的对象。

对象类型

收集方法

方法

备注

也可以看看

AddNew(字符串名称,字符串类型)

目的

注意:将新项目添加到当前集合。

所有集合的界面都是相同的。您必须提供一个名称和类型参数。这些参数的用途取决于所访问的实际集合。例如,当将新元素添加到Elements集合时,Type字符串可以是基本UML元素类型,也可以是概要文件(例如SysML :: Requirement)定义的完全限定元素类型(定型),以将其与标准区别。需求。

还要注意,您必须在返回的对象上调用Update()以完成AddNew函数。如果未调用Update(),则该对象将处于不确定状态。

发生错误时,将引发异常,包括当用户不具有修改指定类型的安全性权限时。

参数:

  • 名称:字符串
  • 类型:字符串(最多30个字符)
AddNew函数

删除(短索引)

空洞

注意:删除选定参考处的项目。

参数:

  • 指数:短

DeleteAt(短索引,布尔值刷新)

空洞

注意:删除选定索引处的项目。第二个参数当前未使用。

参数:

  • 指数:短
  • 刷新:布尔值

GetAt(短索引)

目的

注意:使用数字索引检索数组对象。如果索引超出范围,则会发生错误。

参数:

  • 指数:短

GetByName(字符串名称)

目的

注意:按名称获取当前集合中的项目。支持模型,包,元素,图和元素TaggedValue集合。

如果该集合不包含任何项目(或者对于“标记值”集合,如果该集合包含项目,但该方法无法找到具有指定名称的对象),则该方法返回空值。对于其他集合,如果该方法无法找到具有指定名称的对象,则将引发异常。

参数:

  • 名称:字符串
包装类 元素类别 图类 TaggedValue类

GetLastError()

注意:返回一个字符串值,该字符串值描述与该对象有关的最新错误。

刷新()

空洞

注意:通过重新查询模型并重新加载集合来刷新集合。在添加新项目或删除项目后应调用。

更新()

布尔型

注意:修改或附加新项目后,更新当前Collection对象。

如果返回False,请检查“ GetLastError()”函数以获取更多信息。