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 メンバーはメタデータ自体のサイズ (バイト単位) を受け取ります。
戻り値
種類: 状態
メソッドが成功した場合は、Status 列挙の要素である Ok を返します。
メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。
解説
Image::FindFirstItem および Image::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 |