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 |