Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |