在本主题▼

L_AnnSave

# include“l_bitmap.h”

L_LTANN_APIL_INTL_AnnSave(pFile, hObject, uFormat, fSelected, pSaveOptions)

在指定文件中保存注释。

参数

L_TCHAR* pFile

字符串，包含要保存的文件名。

HANNOBJECThObject

根注释对象的句柄，该对象包括要保存在文件中的所有对象。这通常是一个容器对象。

L_UINTuFormat

标注数据的保存格式。可能取值为:

价值	意义
ANNFMT_EMF	[0x0006]使用Windows EMF格式。
ANNFMT_ENCODED	[0x0004]保存为二进制格式。注意:此格式已被ANNFMT_XML所取代，并且不再受支持
ANNFMT_NATIVE	[0x0000]使用LEAD自己的注释格式。注意:此格式已被ANNFMT_XML所取代，并且不再受支持。
ANNFMT_WMF	[0x0001]使用Windows WMF格式。
ANNFMT_XML	[0x0005]保存为XML文本格式。这是引领新的基于文本的格式，向上兼容。应该使用它而不是ANNFMT_NATIVE。

L_BOOLfSelected

标志，指示要保存哪些对象。可能取值为:

价值	意义
真正的	保存所有将所选属性设置为TRUE的对象。要获取和设置所选属性，请使用L_AnnGetSelected而且L_AnnSetSelected功能。
假	只保存指定的对象。

pSAVEFILEOPTIONpSaveOptions

指向SAVEFILEOPTION结构，该结构包含可选的扩展保存选项。该信息用于在多页注释文件中添加注释页或替换注释页。传递NULL以保存一个单页注释文件。

价值	意义
成功	活动很成功。
< 1	发生错误。指返回代码．

在15.0版本中，基于文本的格式ANNFMT_XML将取代ANNFMT_NATIVE和ANNFMT_ENCODED。注意，ANNFMT_NATIVE和ANNFMT_ENCODED不再被支持作为选项L_AnnSave，L_AnnSaveOffset,L_AnnSaveMemory．

为了向后兼容，这个最新版本的LEADTOOLS可以通过以下函数读取停止使用的格式(ANNFMT_NATIVE和ANNFMT_ENCODED):

ANNFMT_XML格式比旧的注释格式提供了许多优点:

向前和向后兼容。
它是人类可读的。
可以使用标准文本编辑器(即notepad.exe)轻松修改它。
可以使用任何标准XML解析器轻松解析它。
它可以与越来越多的使用XML的实用程序一起使用

以WMF格式保存注释，仅供在其他应用程序中使用。LEADTOOLS只读取本机格式的注释。

为了保留缩放和定位信息，这个函数总是保存根容器以及指定的对象或选定的对象。使用hObject而且fSelected参数如下:

要保存指定的对象，将hObject设置为该对象，并将fSelected设置为FALSE。
要在容器中只保存选中的对象，将hObject设置为容器，并将fSelected设置为TRUE。
要保存容器中的所有对象，将hObject设置为容器，并将fSelected设置为FALSE。
若要将TIF文件中的注释保存为标记，请调用L_AnnSaveTag．

在SAVEFILEOPTION结构可以用于在ANNFMT_XML类型的多页注释文件中添加新页或替换现有页。注意，注释多页文件的所有页面都必须是ANNFMT_XML类型。注释文件不能包含不同格式类型的页面。

向注释多页文件插入新页:

声明一个类型变量SAVEFILEOPTION．
设置SAVEFILEOPTION。uFlags字段到ESO_INSERTPAGE。
设置SAVEFILEOPTION。字段中要插入的位置。新页面将插入到PageNumber字段中指定的页面前面。

替换注释多页文件中已有的页面:

声明一个类型变量SAVEFILEOPTION．
设置SAVEFILEOPTION。uFlags字段到ESO_REPLACEPAGE。
设置SAVEFILEOPTION。PageNumber字段中要替换的页。

若要从注释多页文件中删除页面，请使用L_AnnDeletePage，L_AnnDeletePageMemory，L_AnnDeletePageOffset．

必需的dll和库

LTANN
有关所需dll和库的确切列表(基于工具包版本)，请参见应用程序中包含的文件．

平台

x64 Win32。

另请参阅

功能

主题

例子

另一个例子，参见L_AnnFileInfo．
这个例子将当前选择的注释保存在一个文件中。

L_INT AnnSaveExample(HANNOBJECT hContainer)/*容器注释对象*/｛L_INT nRet;L_AnnSave(MAKE_IMAGE_PATH(TEXT(”测试。安”))， hContainer, ANNFMT_XML, FALSE, NULL);如果(nRet == SUCCESS)对话框(NULL,文本(“保存注释”),文本(“通知”), MB_OK);其他的返回nRet;返回成功;｝

下载我们的免费评估

帮助版本21.0.2021.7.5

栅格成像C API帮助

介绍

版本历史

开始

应用程序中包含的文件

文档编写者-与您的应用程序包含的文件

LEADTOOLS光栅成像功能

快速参考

教程

函数引用

回调函数

特点概述

附录