Метод Image::FindNextItem (gdiplusheaders.h)
Метод Image::FindNextItem используется вместе с методом Image::FindFirstItem для перечисления элементов метаданных, хранящихся в этом объекте Image . Метод Image::FindNextItem извлекает описание и размер данных следующего элемента метаданных в этом объекте Image .
Синтаксис
Status FindNextItem(
[in, out] ImageItemData *item
);
Параметры
[in, out] item
Тип: ImageItemData*
Указатель на объект ImageItemData . На входных данных элемент Desc указывает на буфер (выделенный вызывающим объектом) достаточно большой для хранения описания метаданных (1 байт для JPEG, 4 байта для PNG, 11 байтов для GIF), а член DescSize задает размер (1, 4 или 6) буфера, на который указывает Desc. В выходных данных буфер, на который указывает Desc, получает описание метаданных, а член DataSize получает размер в байтах самих метаданных.
Возвращаемое значение
Тип: Состояние
В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .
Если метод завершается ошибкой, он возвращает один из других элементов перечисления Status .
Комментарии
Image::FindFirstItem и Image::FindNextItem не перечисляют элементы метаданных, хранящиеся с помощью метода Image::SetPropertyItem .
Примеры
В следующем примере отображается описание и размер данных для каждого элемента метаданных в объекте 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);
}
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | gdiplusheaders.h (включая Gdiplus.h) |
| Библиотека | Gdiplus.lib |
| DLL | Gdiplus.dll |