L_EnumFileTags

# include“l_bitmap.h”

L_LTFIL_APIL_INTL_EnumFileTags (pszFile, uFlags, pfnCallback, pUserData, pLoadOptions)

枚举文件中的所有TIFF标记。请参阅下面的评论部分,以获得支持TIFF标记的格式列表。

参数

L_TCHAR* pszFile

包含要在其中枚举标记的文件名的字符串。

L_UINTuFlags

旗帜参数。保留以备将来使用。通过0。

ENUMTAGSCALLBACKpfnCallback

枚举每个标记的回调函数。使用函数指针作为此参数的值。L_EnumFileTagscalls this callback function for each tag. The callback function must adhere to the function prototype described in theENUMTAGSCALLBACK回调函数。

L_VOID* pUserData

可用于传递回调函数所需的一个或多个附加参数的Void指针。若要使用此功能,请为变量赋值或创建包含所需多个字段的结构。然后,在这个参数中传递变量或结构的地址,并将其强制转换为L_VOID *。回调函数在其自己的pUserData参数中接收地址,可以将其强制转换为适当数据类型的指针,以访问变量或结构。

pLOADFILEOPTIONpLoadOptions

指向可选扩展加载选项的指针。传递NULL来使用默认的加载选项。

返回

价值 意义
成功 函数运行成功。
< 1 发生错误。指返回代码

评论

对于多页TIFF文件,可以枚举来自特定页面的标记。指定要在其上枚举标记的页码pLoadOptions结构。有关更多信息,请参阅LOADFILEOPTION结构。

这个函数枚举标准TIFF标记和用户标记。标准TIFF标签小于32767。用户TIFF标签通常在32768到65535之间。

要读取标记值,请调用L_ReadFileTag

注意,如果ENUMTAGSCALLBACK返回的值不是SUCCESS,则L_EnumFileTags将停止枚举标记并返回由ENUMTAGSCALLBACK作为返回值。

不要试图使用L_DeleteTag属性中删除标记的函数ENUMTAGSCALLBACK回调函数。如果要删除枚举的标记,请使用enumtagcallback将标记添加到列表中。从L_EnumFileTags返回后,您可以从列表中删除所有标记。

有关TIFF标签的一般信息,请参见实现TIFF注释和标签。

所需的dll和库

平台

Win32, x64, Linux。

另请参阅

功能

主题

例子

这个例子将从"file.tif"的第1页读取所有的用户标签。

L_INT EXT_CALLBACK EnumFileTagCallbackL_UINT16 uType,L_UINT32 uCount,L_VOID * userdata)UNREFERENCED_PARAMETER (pUserData);L_TCHAR s [100];wsprintf(年代,文本("标签= %d,类型= %d,计数= %d"), uTag, uType, uCount);MessageBox(NULL, s, TEXT)“EnumFileTagCallback”), MB_OK);返回成功;L_INT enumfiletagexample (HWND)/*列举标签*/UNREFERENCED_PARAMETER (hWnd);返回L_EnumFileTags (MAKE_IMAGE_PATH(文本(“OCR1.tif”), 0, EnumFileTagCallback, NULL, NULL);

LEADTOOLS光栅成像C API帮助
188金宝搏的网址客服|支持|联系我们|知识产权公告
©1991 - 2021领先科技有限公司版权所有。