Image::FindNextItem-Methode (gdiplusheaders.h)

  • Artikel

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

Weitere Informationen

Bild

Image::GetItemData