Método Image::FindFirstItem (gdiplusheaders.h)
O método Image::FindFirstItem recupera a descrição e o tamanho dos dados do primeiro item de metadados neste objeto Image .
Sintaxe
Status FindFirstItem(
[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.
Retornar valor
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
Use Image::FindFirstItem junto com Image::FindNextItem para enumerar os itens de metadados, incluindo metadados personalizados, armazenados em uma imagem. Image::FindFirstItem e Image::FindNextItem não enumeram os itens de metadados armazenados pelo método Image::SetPropertyItem .
Requisitos
| Requisito | Valor |
|---|---|
| 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 |