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

Artículo
08/24/2023

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