Metodo Image::FindNextItem (gdiplusheaders.h)

Il metodo Image::FindNextItem viene utilizzato insieme al metodo Image::FindFirstItem per enumerare gli elementi di metadati archiviati in questo oggetto Image . Il metodo Image::FindNextItem recupera la descrizione e le dimensioni dei dati dell'elemento di metadati successivo in questo oggetto Image .

Sintassi

Status FindNextItem(
  [in, out] ImageItemData *item
);

Parametri

[in, out] item

Tipo: ImageItemData*

Puntatore a un oggetto ImageItemData . Nell'input, il membro Desc punta a un buffer (allocato dal chiamante) sufficientemente grande da contenere la descrizione dei metadati (1 byte per JPEG, 4 byte per PNG, 11 byte per GIF) e il membro DescSize specifica le dimensioni (1, 4 o 6) del buffer a cui punta Desc. Nell'output, il buffer a cui punta Desc riceve la descrizione dei metadati e il membro DataSize riceve le dimensioni, in byte, dei metadati stessi.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Image::FindFirstItem e Image::FindNextItem non enumerare gli elementi di metadati archiviati dal metodo Image::SetPropertyItem .

Esempio

Nell'esempio seguente vengono visualizzate la descrizione e le dimensioni dei dati per ogni elemento di metadati in un oggetto 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);
}

Requisiti

Vedi anche

Immagine

Image::GetItemData