Método Image::RemovePropertyItem (gdiplusheaders.h)
El método Image::RemovePropertyItem quita un elemento de propiedad (fragmento de metadatos) de este objeto Image .
Sintaxis
Status RemovePropertyItem(
[in] PROPID propId
);
Parámetros
[in] propId
Tipo: PROPID
Entero que identifica el elemento de propiedad que se va a quitar.
Valor devuelto
Tipo: Estado
Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .
Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .
Comentarios
El método Image::RemovePropertyItem quita una propiedad especificada de un objeto Image , pero ese elemento de propiedad no se quita del archivo o secuencia que se usó para construir el objeto Image . Para guardar la imagen (con el elemento de propiedad quitado) en un nuevo archivo JPEG o secuencia, llame al método Save del objeto Image .
Ejemplos
En el ejemplo siguiente se crea un objeto Image basado en un archivo JPEG. El código quita el elemento de propiedad PropertyTagEquipMake del objeto Image llamando a su método Image::RemovePropertyItem . El código llama a Image::GetPropertyItemSize dos veces (una vez antes y una vez después de quitar el elemento) para determinar el tamaño del elemento de propiedad PropertyTagEquipMake. El código no quita el elemento de propiedad del archivo de imagen; quita el elemento de propiedad solo del 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;
}
El código anterior, junto con un archivo determinado, FakePhoto3.jpg, produjo la siguiente salida:
The size of the PropertyTagEquipMake item is 33.
The size of the PropertyTagEquipMake item is 0.
Requisitos
| Cliente mínimo compatible | Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | gdiplusheaders.h (include Gdiplus.h) |
| Library | Gdiplus.lib |
| Archivo DLL | Gdiplus.dll |