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——在文本缓冲区而非文件中返回 HTMLETSC_HTML_NT_IMAGEMAP_OPT_NO_RECURSE——不包含子子网ETSC_HTML_NT_IMAGEMAP_OPT_GENERATE_OBJECT_LINKS——创建带有指向各对象页面的超链接的 HTMLETSC_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)开头的对象名称创建超链接,而不是使用完整的层次名称