上一页 | 下一页 |
集合类
Collection是Automation Interface中所有元素使用的主集合类。它包含迭代集合,刷新集合和从集合中删除项目的方法。
重要的是要意识到,当调用AddNew时,该项不会自动添加到当前集合中。典型的步骤是:
- 调用AddNew以添加新项目
- 根据需要修改项目
- 调用项目上的更新以将其保存到数据库
- 在集合上调用Refresh以将其包含在当前集合中
删除是一样的; 在调用Refresh之前,该集合仍包含对已删除项目的引用,该引用不应被调用。
每种方法都可用于迭代支持此类构造的语言的集合。
集合属性
属性 |
备注 |
也可以看看 |
---|---|---|
计数 |
短 备注:只读 此列表引用的对象数。 |
|
对象类型 |
对象类型 备注:只读 区分通过Dispatch接口引用的对象。 |
对象类型 |
收集方法
方法 |
备注 |
也可以看看 |
---|---|---|
AddNew(字符串名称, |
目的 注意:向当前集合添加新项目。 所有集合的界面都相同; 您必须提供名称和类型参数。这些参数的用途取决于所访问的实际集合。例如,在向Elements集合添加新元素时,Type字符串可以是基本UML元素类型,也可以是由配置文件定义的完全限定元素类型(构造型),例如SysML :: Requirement,将其与标准区分开来需求。 另请注意,必须在返回的对象上调用Update()才能完成AddNew。如果未调用Update(),则对象将处于不确定状态。 参数:
|
AddNew函数 |
删除(短索引) |
空虚 注意:删除所选参考的项目。 参数:
|
|
DeleteAt(短索引,布尔刷新) |
空虚 注意:删除所选索引处的项目。第二个参数当前未使用。 参数:
|
|
GetAt(短指数) |
目的 注意:使用数字索引检索数组对象。如果索引超出范围,则会发生错误。 参数:
|
|
GetByName(字符串名称) |
目的 注意:按名称获取当前集合中的项目。支持Model,Package,Element,Diagram和元素TaggedValue集合。 如果集合不包含任何项(或者,对于标记值集合,如果集合包含项但方法无法找到具有指定名称的对象),则该方法返回空值。对于其他集合,如果方法无法找到具有指定名称的对象,则会引发异常。 参数:
|
包类Element元图类TaggedValue类 |
GetLastError函数() |
串 注意:返回一个字符串值,描述与此对象相关的最新错误。 |
|
刷新() |
空虚 注意:通过重新查询模型并重新加载集合来刷新集合。应在添加新项目后或删除项目后调用。 |
|
更新() |
布尔 注意:修改或附加新项目后更新当前的Collection对象。 如果返回False,请检查'GetLastError()'函数以获取更多信息。 |