Método Image::RemovePropertyItem (gdiplusheaders.h)
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 |