Image::FindNextItem 方法 (gdiplusheaders.h)

Image::FindNextItem 方法与 Image::FindFirstItem 方法一起使用,以枚举此 Image 对象中存储的元数据项。 Image::FindNextItem 方法检索此 Image 对象中下一个元数据项的说明和数据大小。

语法

Status FindNextItem(
  [in, out] ImageItemData *item
);

parameters

[in, out] item

类型: ImageItemData*

指向 ImageItemData 对象的指针。 输入时,Desc 成员指向由调用方分配的缓冲区 (,) 足够大,以便保存元数据说明 (JPEG 为 1 字节,4 个字节用于 PNG,11 个字节用于 GIF) ,DescSize 成员指定 desc 指向的缓冲区的大小 (1、4 或 6) 。 在输出时,Desc 指向的缓冲区接收元数据说明,DataSize 成员接收元数据本身的大小(以字节为单位)。

返回值

类型: 状态

如果方法成功,则返回 Ok,这是 Status 枚举的元素。

如果 方法失败,它将返回 Status 枚举的其他元素之一。

注解

Image::FindFirstItemImage::FindNextItem 不枚举 Image::SetPropertyItem 方法存储的元数据项。

示例

以下示例显示 Image 对象中每个元数据项的说明和数据大小。

Status stat;        
Image image(L"River5.png");

CHAR descBuf[5] = {0, 0, 0, 0, 0};
ImageItemData itemData;
ZeroMemory(&itemData, sizeof(itemData));
itemData.Size = sizeof(itemData);
itemData.DescSize = 4;
itemData.Desc = descBuf;

stat = image.FindFirstItem(&itemData);

while(Ok == stat)
{
   printf("%s   %d\n", itemData.Desc, itemData.DataSize);
   stat = image.FindNextItem(&itemData);
}

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 gdiplusheaders.h (包括 Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

另请参阅

图像

Image::GetItemData