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

  • Artigo

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

Confira também

Imagem

Image::GetItemData