Image::FindNextItem-Methode (gdiplusheaders.h)
Die Image::FindNextItem-Methode wird zusammen mit der Image::FindFirstItem-Methode verwendet, um die in diesem Image-Objekt gespeicherten Metadatenelemente aufzulisten. Die Image::FindNextItem-Methode ruft die Beschreibung und die Datengröße des nächsten Metadatenelements in diesem Image-Objekt ab.
Syntax
Status FindNextItem(
[in, out] ImageItemData *item
);
Parameter
[in, out] item
Typ: ImageItemData*
Zeiger auf ein ImageItemData-Objekt . Bei der Eingabe zeigt das Desc-Element auf einen Puffer (vom Aufrufer zugeordnet), der groß genug ist, um die Metadatenbeschreibung (1 Byte für JPEG, 4 Bytes für PNG, 11 Bytes für GIF) zu speichern, und das DescSize-Element gibt die Größe (1, 4 oder 6) des Puffers an, auf den Von Desc verweist. Bei der Ausgabe empfängt der Puffer, auf den Von Desc verweist, die Metadatenbeschreibung, und das DataSize-Element empfängt die Größe der Metadaten selbst in Bytes.
Rückgabewert
Typ: Status
Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .
Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.
Hinweise
Image::FindFirstItem und Image::FindNextItem werden die Metadatenelemente, die von der Image::SetPropertyItem-Methode gespeichert sind, nicht aufgezählt.
Beispiele
Im folgenden Beispiel werden die Beschreibung und die Datengröße für jedes Metadatenelement in einem Image-Objekt angezeigt.
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);
}
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | gdiplusheaders.h (include Gdiplus.h) |
| Bibliothek | Gdiplus.lib |
| DLL | Gdiplus.dll |