在本主题▼

L_WriteFileTag

# include“l_bitmap.h”

L_LTFIL_APIL_INTL_WriteFileTag (pszFile pSaveOptions)

将标记写入文件或更改文件中的现有标记。

参数

L_TCHAR* pszFile

包含文件名的字符串。

pSAVEFILEOPTIONpSaveOptions

指向可选扩展保存选项的指针。传递NULL以使用默认的保存选项。pSaveOptions。PageNumber表示要在其上写入标记的页。注意，如果页面不存在，将返回错误代码。

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

此函数将标记写入现有文件或更改现有文件中的标记。

此函数将写入已设置的所有标记L_SetTag．这个函数必须至少设置一个标记才能工作。如果没有设置任何标记，则此函数将返回错误。

此函数仅适用于TIFF文件。

如果使用IFD指示将标记写入哪个页面，则此函数会受到一些限制。看到加载和保存大TIFF/BigTIFF文件主题以获取更多信息。

请注意:请谨慎使用该功能。LEADTOOLS不会限制您编写的标记。如果您编写了错误的标记，则文件可能会损坏。有关预定义标记的列表，请参阅TIF188宝金博安卓下载F文档。建议只编写用户自定义的标记(0x8000 ~ 0xFFFF之间的标记)。

有关TIFF标记和类型的完188宝金博安卓下载整列表，请参阅TIFF文档。

当您添加或删除注释或标记时，TIFF/Exif图像文件末尾的注释和标记数组将被重写。修改现有注释或标记时，将向文件添加新值，并根据需要修改IFD。在所有这些情况下，没有图像重新压缩。

必需的dll和库

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

平台

Win32, x64, Linux。

另请参阅

功能

主题

例子

L_INT WriteFileTagExample ()｛L_INT nRet;L_UINT16 logposition = 0x8001;/*我的私有标签*/L_UINT16 TagType = TAG_SHORT;/*标记的数据类型*/L_UINT32 TagCount = 4;/*数据项个数*/L_INT16 TagData[] = {5,5,24,37};L_VOID* pTagData = &TagData;/*指针指向包含数据*/的缓冲区SAVEFILEOPTION SAVEFILEOPTION;/*设置要保存的标签数据*/nRet = L_SetTag(logposition, TagType, TagCount, pTagData);如果(nRet < SUCCESS)返回nRet;nRet = L_GetDefaultSaveFileOption(&SaveFileOption)运算符(SAVEFILEOPTION));如果(nRet != SUCCESS)返回nRet;SaveFileOption。PageNumber = 1;/*保存带有标记的文件。注意，TEST.TIF必须存在并且至少包含一个页面!* /L_WriteFileTag(MAKE_IMAGE_PATH(TEXT)“TEST.TIF”)), &SaveFileOption);如果(nRet != SUCCESS)返回nRet;/*从内存中清除标签*/nRet = L_SetTag(0, 0, 0, NULL);返回成功;｝