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