Metodo Image::RemovePropertyItem (gdiplusheaders.h)

Articolo
08/24/2023

Il metodo Image::RemovePropertyItem rimuove un elemento della proprietà (parte dei metadati) da questo oggetto Image .

Sintassi

Status RemovePropertyItem(
  [in] PROPID propId
);

Parametri

[in] propId

Tipo: PROPID

Intero che identifica l'elemento della proprietà da rimuovere.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Il metodo Image::RemovePropertyItem rimuove una proprietà specificata da un oggetto Image , ma tale elemento di proprietà non viene rimosso dal file o dal flusso usato per costruire l'oggetto Image . Per salvare l'immagine (con l'elemento della proprietà rimossa) in un nuovo file JPEG o in un flusso, chiamare il metodo Save dell'oggetto Image .

Esempio

Nell'esempio seguente viene creato un oggetto Image basato su un file JPEG. Il codice rimuove l'elemento della proprietà PropertyTagEquipMake dall'oggetto Image chiamando il relativo metodo Image::RemovePropertyItem . Il codice chiama Image::GetPropertyItemSize due volte (una volta prima e una volta dopo la rimozione dell'elemento) per determinare le dimensioni dell'elemento della proprietà PropertyTagEquipMake. Il codice non rimuove l'elemento della proprietà dal file di immagine; rimuove l'elemento della proprietà solo dall'oggetto 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;
}

Il codice precedente, insieme a un determinato file, FakePhoto3.jpg, ha prodotto l'output seguente:

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

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusheaders.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll