共用方式為


Image::FindFirstItem 方法 (gdiplusheaders.h)

Image::FindFirstItem 方法會擷取此 Image 物件中第一個元數據專案的描述和數據大小。

語法

Status FindFirstItem(
  [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::FindFirstItem 以及 Image::FindNextItem 來列舉元數據專案,包括儲存在影像中的自定義元數據。 Image::FindFirstItemImage::FindNextItem 不會列舉 Image::SetPropertyItem 方法所儲存的元數據專案。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 gdiplusheaders.h (包含 Gdiplus.h)
程式庫 Gdiplus.lib
Dll Gdiplus.dll

另請參閱

映像

Image::GetItemData