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

O método Image::FindNextItem é usado junto com o método Image::FindFirstItem para enumerar os itens de metadados armazenados neste objeto Image . O método Image::FindNextItem recupera a descrição e o tamanho dos dados do próximo item de metadados neste objeto Image .

Sintaxe

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

Parâmetros

[in, out] item

Tipo: ImageItemData*

Ponteiro para um objeto ImageItemData . Na entrada, o membro Desc aponta para um buffer (alocado pelo chamador) grande o suficiente para manter a descrição dos metadados (1 byte para JPEG, 4 bytes para PNG, 11 bytes para GIF) e o membro DescSize especifica o tamanho (1, 4 ou 6) do buffer apontado por Desc. Na saída, o buffer apontado por Desc recebe a descrição dos metadados e o membro DataSize recebe o tamanho, em bytes, dos próprios metadados.

Valor retornado

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Image::FindFirstItem e Image::FindNextItem não enumeram os itens de metadados armazenados pelo método Image::SetPropertyItem .

Exemplos

O exemplo a seguir exibe a descrição e o tamanho dos dados de cada item de metadados em um 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 com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusheaders.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll

Confira também

Imagem

Image::GetItemData