Image::FindNextItem, méthode (gdiplusheaders.h)
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 |