Image::FindNextItem, méthode (gdiplusheaders.h)

  • Article

La méthode Image::FindNextItem est utilisée avec la méthode Image::FindFirstItem pour énumérer les éléments de métadonnées stockés dans cet objet Image . La méthode Image::FindNextItem récupère la description et la taille des données de l’élément de métadonnées suivant dans cet objet Image .

Syntaxe

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

Paramètres

[in, out] item

Type : ImageItemData*

Pointeur vers un objet ImageItemData . Lors de l’entrée, le membre Desc pointe vers une mémoire tampon (allouée par l’appelant) suffisamment grande pour contenir la description des métadonnées (1 octet pour JPEG, 4 octets pour PNG, 11 octets pour GIF), et le membre DescSize spécifie la taille (1, 4 ou 6) de la mémoire tampon pointée par Desc. Lors de la sortie, la mémoire tampon pointée par Desc reçoit la description des métadonnées, et le membre DataSize reçoit la taille, en octets, des métadonnées elles-mêmes.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Notes

Image::FindFirstItem et Image::FindNextItem n’énumèrent pas les éléments de métadonnées stockés par la méthode Image::SetPropertyItem .

Exemples

L’exemple suivant affiche la description et la taille des données pour chaque élément de métadonnées dans un objet 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);
}

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête gdiplusheaders.h (inclure Gdiplus.h)
Bibliothèque Gdiplus.lib
DLL Gdiplus.dll

Voir aussi

Image

Image::GetItemData