Image::FindNextItem 方法 (gdiplusheaders.h)

Image::FindNextItem方法會與Image::FindFirstItem方法搭配使用,以列舉儲存在此Image物件中的中繼資料專案。 Image::FindNextItem方法會擷取此Image物件中下一個中繼資料專案的描述和資料大小。

語法

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

參數

[in, out] item

類型: ImageItemData*

ImageItemData物件的指標。 在輸入時,Desc 成員會指向呼叫端所配置的緩衝區 () 夠大,足以保存 JPEG 的中繼資料描述 (1 位元組、PNG 的 4 個位元組、GIF) 11 個位元組,而 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)
程式庫 Gdiplus.lib
Dll Gdiplus.dll

另請參閱

映像

Image::GetItemData