上一页 下一页

集合类

Collection是Automation Interface中所有元素使用的主集合类。它包含迭代集合,刷新集合和从集合中删除项目的方法。

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

  • 调用AddNew以添加新项目
  • 根据需要修改项目
  • 调用项目上的更新以将其保存到数据库
  • 在集合上调用Refresh以将其包含在当前集合中

删除是一样的; 在调用Refresh之前,该集合仍包含对已删除项目的引用,该引用不应被调用。

每种方法都可用于迭代支持此类构造的语言的集合。

集合属性

属性

备注

也可以看看

计数

备注:只读

此列表引用的对象数。

对象类型

对象类型

备注:只读

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

对象类型

收集方法

方法

备注

也可以看看

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

目的

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

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

另请注意,必须在返回的对象上调用Update()才能完成AddNew。如果未调用Update(),则对象将处于不确定状态。

参数:

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

删除(短索引)

空虚

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

参数:

  • 指数:空头

DeleteAt(短索引,布尔刷新)

空虚

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

参数:

  • 指数:空头
  • 刷新:布尔值

GetAt(短指数)

目的

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

参数:

  • 指数:空头

GetByName(字符串名称)

目的

注意:按名称获取当前集合中的项目。支持Model,Package,Element,Diagram和元素TaggedValue集合。

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

参数:

  • 名称:字符串
包类Element元图类TaggedValue类

GetLastError函数()

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

刷新()

空虚

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

更新()

布尔

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

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