Método Image::FindNextItem (gdiplusheaders.h)

El método Image::FindNextItem se usa junto con el método Image::FindFirstItem para enumerar los elementos de metadatos almacenados en este objeto Image . El método Image::FindNextItem recupera la descripción y el tamaño de los datos del siguiente elemento de metadatos de este objeto Image .

Sintaxis

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

Parámetros

[in, out] item

Tipo: ImageItemData*

Puntero a un objeto ImageItemData . En la entrada, el miembro Desc apunta a un búfer (asignado por el autor de la llamada) lo suficientemente grande como para contener la descripción de metadatos (1 byte para JPEG, 4 bytes para PNG, 11 bytes para GIF) y el miembro DescSize especifica el tamaño (1, 4 o 6) del búfer al que apunta Desc. En la salida, el búfer al que apunta Desc recibe la descripción de los metadatos y el miembro DataSize recibe el tamaño, en bytes, de los propios metadatos.

Valor devuelto

Tipo: Estado

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Image::FindFirstItem e Image::FindNextItem no enumeran los elementos de metadatos almacenados por el método Image::SetPropertyItem .

Ejemplos

En el ejemplo siguiente se muestra la descripción y el tamaño de los datos de cada elemento de metadatos de un objeto 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);
}

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusheaders.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll

Consulte también

Imagen

Image::GetItemData