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

Artigo
08/24/2023

O método Image::RemovePropertyItem remove um item de propriedade (parte dos metadados) desse objeto Image .

Sintaxe

Status RemovePropertyItem(
  [in] PROPID propId
);

Parâmetros

[in] propId

Tipo: PROPID

Inteiro que identifica o item de propriedade a ser removido.

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

O método Image::RemovePropertyItem remove uma propriedade especificada de um objeto Image , mas esse item de propriedade não é removido do arquivo ou fluxo que foi usado para construir o objeto Image . Para salvar a imagem (com o item de propriedade removido) em um novo arquivo ou fluxo JPEG, chame o método Save do objeto Image .

Exemplos

O exemplo a seguir cria um objeto Image com base em um arquivo JPEG. O código remove o item de propriedade PropertyTagEquipMake do objeto Image chamando seu método Image::RemovePropertyItem . O código chama Image::GetPropertyItemSize duas vezes (uma vez antes e uma depois de remover o item) para determinar o tamanho do item de propriedade PropertyTagEquipMake. O código não remove o item de propriedade do arquivo de imagem; ele remove o item de propriedade somente do objeto Image .

#include <windows.h>
#include <gdiplus.h>
#include <stdio.h>
using namespace Gdiplus;

INT main()
{
   GdiplusStartupInput gdiplusStartupInput;
   ULONG_PTR gdiplusToken;
   GdiplusStartup(&gdiplusToken, &gdiplusStartupInput, NULL);

   Image* image = new Image(L"FakePhoto3.jpg");
   UINT size = 0;

   size = image->GetPropertyItemSize(PropertyTagEquipMake);
   printf("The size of the PropertyTagEquipMake item is %u.\n", size);

   image->RemovePropertyItem(PropertyTagEquipMake);   

   size = image->GetPropertyItemSize(PropertyTagEquipMake);
   printf("The size of the PropertyTagEquipMake item is %u.\n", size);

   delete image;
   GdiplusShutdown(gdiplusToken);
   return 0;
}

O código anterior, juntamente com um arquivo específico, FakePhoto3.jpg, produziu a seguinte saída:

The size of the PropertyTagEquipMake item is 33.
The size of the PropertyTagEquipMake item is 0.

Requisitos


Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusheaders.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll