Subnet 子包
Network 包提供了修改和查询子网的 API。子网是可以包含其他网络对象的对象。例如,一个子网可以表示一座城市,其中包含多个以子节点表示的交换机。
接口 Ets_Nt_Subnet_Current_Get() 返回给定模型当前子网的 ETS 对象句柄,而 Ets_Nt_Subnet_Current_Set() 允许你把某个子网设为当前活动子网。Ets_Nt_Subnet_Map_Set() 和 Ets_Nt_Subnet_Map_Get() 分别设置和获取给定子网的当前地理地图。要获取地图的包围矩形(以经纬度表示),使用 Ets_Nt_Subnet_Map_Extents_Get()。你还可以显示等高线地图,它们通过 Ets_Nt_Subnet_Iso_Map_Names_Set() 与子网关联,并通过 Ets_Nt_Subnet_Iso_Map_Names_Get() 查询。
Ets_Nt_Subnet_Bounds_Get() 提供了获取子网所表示区域大小的方法,而 Ets_Nt_Subnet_Objview_Coords_Get() 返回覆盖子网内所有对象的区域(可能比子网的实际区域更小)。Ets_Nt_Subnet_View_Coords_Get() 以父级单位返回子网左上角和右下角的坐标,而 Ets_Nt_Subnet_View_Coords_Set() 用于设置这些坐标。要把视图设置为显示子网中的所有对象,使用 Ets_Nt_Subnet_Zoom_To_Content()。
子网的网格样式、颜色和单位可以通过接口 Ets_Nt_Subnet_Grid_Properties_Set() 和 Ets_Nt_Subnet_Grid_Properties_Get() 进行设置和查询。两个接口都允许你指定要设置或查询的属性,所提供的值取决于属性的种类。
要从给定子网移除所有属性,使用 Ets_Nt_Subnet_Clear()。
子网包含数量不定的层——称为切片(slice)——存储特定类型的信息供工作区显示。Ets_Nt_Subnet_Slice_Count_Get() 返回指定子网中切片的数量。你可以用 Ets_Nt_Subnet_Slice_Insert()、Ets_Nt_Subnet_Slice_Nth_Get() 和 Ets_Nt_Subnet_Slice_Nth_Remove() 在子网中添加或移除切片。(Slice 子包用于管理切片。)
你可以用 Ets_Nt_Subnet_Image_Capture() 或 Ets_Nt_Subnet_Image_Capture_Core() 捕获子网的图像。
子网分组
Subnet 子包包含一个函数和三种回调类型,用于支持 Group Nodes into Subnets(将节点分组到子网)功能。回调类型用于创建实现子网分组插件的函数。函数 Ets_Nt_Subnet_Grouping_Perform() 通过把分组设置文件应用于一组节点来创建新的子网层次结构。
子网分组插件为 Group Nodes into Subnets 功能定义一种分组操作。它是一组回调函数,GUI 用它们向用户请求分组参数、显示参数并执行实际的分组。插件由两个文件组成:注册所需回调函数的分组定义文件,以及实现这些回调的库。两个文件都必须位于 “mod_dirs“ 首选项列出的目录中。(分组插件位于 <reldir>/sys/utilities 目录。)
分组定义文件是扩展名为 .gpf 的文本文件,包含一个或多个插件描述,形式如下例所示:
start_grouping_definition
grouping name: Move nodes to a subnet
description: Moves a specified group of nodes into a new subnet
parameter dialog callback: move_nodes_lib move_nodes_param_dialog_callback
parameter display callback: move_nodes_lib move_nodes_param_display_callback
grouping callback: move_nodes_lib move_nodes_perform_callback
end_grouping_definition
各定义元素的含义如下:
- grouping name——用于查找特定插件的唯一标识。该名称显示在 Grouping Operations 对话框的 Operation 弹出菜单中。
- description——分组的扩展描述。
- parameter dialog callback——用于向用户请求分组参数的库和函数名。其原型见
EtsT_Nt_Subnet_Grouping_Param_Dialog_Callback。该元素是可选的,不需要参数时可以省略。 - parameter display callback——用于向用户显示分组参数的库和函数名。其原型见
EtsT_Nt_Subnet_Grouping_Param_Display_Callback。该元素是可选的,未请求参数时可以省略。 - grouping callback——用于执行实际分组操作的库和函数名。其原型见
EtsT_Nt_Subnet_Grouping_Perform_Callback。