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 |