EtsT_Nt_Subnet_Grouping_Perform_Callback
摘要
回调:用于执行子网分组操作。
语法
<grouping_perform_callback_name> (input_nodes, params)
| 参数 | 类型 | 说明 |
|---|---|---|
input_nodes |
EtsT_Obj_List * |
待分组成子网的节点列表。 |
params |
PrgT_List * |
用于控制分组操作的参数。 |
返回类型
PrgT_List *
类型为 EtsT_Obj_Group 的对象组列表。
头文件
ets_api_nt.h
详情
此回调类型用于 Group Nodes into Subnets(将节点分组成子网)功能。每当 GUI 需要执行分组操作时,都会调用此类型的函数。
该函数应使用 params 中的参数处理 input_nodes 中列出的节点并据此分组。分组结果应按如下方式返回:
- 已成功分组的节点应从
input_nodes列表中移除,并添加到创建的对象组中。这些对象组应作为 PrgT_List 的元素返回。 - 不属于任何组的节点应保留在
input_nodes列表中。
返回的对象组可以用 Object 包中的下列函数进行操作(参见“General Sub-Package“ 第 1006 页):
- Ets_Obj_Group_Create()
- Ets_Obj_Group_Destroy()
- Ets_Obj_Group_Name_Get()
- Ets_Obj_Group_Name_Set()
- Ets_Obj_Group_Obj_List_Get()
注意: params 指向的 PrgT_List 归应用程序所有;该函数可以添加或删除元素,但不应销毁该列表。
此类型的函数在分组定义(.gpf)文件中注册。详见子网分组。