Ets_Html_Nt_Imagemap_Generate_Core()

摘要

生成一个包含子网图的 HTML 页面,并带选项。

语法

Ets_Html_Nt_Imagemap_Generate_Core (nt_model_hndl, subnet_hndl, directory, main_page_name, options, image_names_tlptr, external_image_name, image_ptr, status_ptr)
参数 类型 说明
nt_model_hndl EtsT_Model_Handle 包含目标子网的模型。(如果为空或无效,则使用当前项目。)
subnet_hndl EtsT_Obj_Handle 目标子网。(如果为空或无效,则使用顶层子网。)
directory const char * 存放所生成 HTML 页面的目录。
main_page_name const char * 所生成 HTML 页面的名称。
options int 生成 HTML 页面的选项(参见 options)。
image_names_tlptr VosT_Textlist * 用于填入所生成图像文件名称的列表(由调用者拥有),如不需要则为 PRGC_NIL。
external_image_name char * 用于将所生成 HTML 链接到先前捕获的图像的名称。仅当设置了 ETSC_HTML_NT_IMAGEMAP_OPT_USE_EXTERNAL_IMAGE 选项时使用。
image_ptr void * 用于存放所生成图像缓冲区副本的区域。仅当设置了 ETSC_NT_SUBNET_IMAGE_CAPTURE_OPT_IMAGE_BUFFER 时使用)。
status_ptr EtsT_Compcode * 操作结果,为 EtsC_Compcode_Success 或 EtsC_Compcode_Failure。

返回类型

char *

PRGC_NIL,或主 HTML 页面(如果设置了 ETSC_HTML_NT_IMAGEMAP_OPT_GENERATE_BUFFER 选项)

头文件

ets_api_html.h

详情

该函数创建带有指定子网及其所有子子网图像映射的 HTML 页面,并附带为每个对象提供属性信息的链接页面。图像映射保存在 directory 中。你可以通过指定不同的选项以多种方式更改默认输出。

options

options 必须是 ETSC_HTML_NT_IMAGEMAP_OPT_NONE,或者是以下一个或多个常量按 OR 组合的值:

  • ETSC_HTML_NT_IMAGEMAP_OPT_EXCLUDE_ATTRIBUTES——不为每个对象创建包含属性数据的页面
  • ETSC_HTML_NT_IMAGEMAP_OPT_SKIP_SIMPLE_SUBNETS——从第一个包含的不仅是单个子网的子网(subnet_hndl 或其子子网)开始生成图像映射
  • ETSC_HTML_NT_IMAGEMAP_OPT_GRAPHICS_PNG——以 PNG 格式创建图形(默认是 GIF)
  • ETSC_HTML_NT_IMAGEMAP_OPT_GENERATE_BUFFER——在文本缓冲区而非文件中返回 HTML
  • ETSC_HTML_NT_IMAGEMAP_OPT_NO_RECURSE——不包含子子网
  • ETSC_HTML_NT_IMAGEMAP_OPT_GENERATE_OBJECT_LINKS——创建带有指向各对象页面的超链接的 HTML
  • ETSC_HTML_NT_IMAGEMAP_OPT_NO_RESOLUTION_ADJUST——保持子网分辨率不变(通常,该函数会临时更改子网的分辨率以捕获其全部内容)
  • ETSC_HTML_NT_IMAGEMAP_OPT_USE_EXTERNAL_IMAGE——不捕获图形图像;取而代之,将 HTML 图像映射链接到由 external_image_name 参数指定的先前捕获的图像
  • ETSC_HTML_NT_IMAGEMAP_OPT_ONLY_IMAGE_TEXT——只生成图像映射的文本而非完整页面(这允许将该文本纳入另一个页面)
  • ETSC_HTML_NT_IMAGEMAP_OPT_NEW_BROWSER——生成将在新浏览器窗口中打开的超链接
  • ETSC_HTML_NT_IMAGEMAP_OPT_IS_TOP——使用以目标子网(subnet_hndl)开头的对象名称创建超链接,而不是使用完整的层次名称

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com