Метод 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

См. также раздел

Изображение

Image::GetItemData