Image::RemovePropertyItem-Methode (gdiplusheaders.h)
Die Image::RemovePropertyItem-Methode entfernt ein Eigenschaftselement (Metadatenelement) aus diesem Image-Objekt .
Syntax
Status RemovePropertyItem(
[in] PROPID propId
);
Parameter
[in] propId
Typ: PROPID
Ganze Zahl, die das zu entfernende Eigenschaftselement angibt.
Rückgabewert
Typ: Status
Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .
Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.
Hinweise
Die Image::RemovePropertyItem-Methode entfernt eine angegebene Eigenschaft aus einem Image-Objekt , aber dieses Eigenschaftselement wird nicht aus der Datei oder dem Stream entfernt, die zum Erstellen des Image-Objekts verwendet wurde. Um das Bild (mit entferntem Eigenschaftselement) in einer neuen JPEG-Datei oder einem neuen JPEG-Stream zu speichern, rufen Sie die Save-Methode des Image-Objekts auf.
Beispiele
Im folgenden Beispiel wird ein Image-Objekt basierend auf einer JPEG-Datei erstellt. Der Code entfernt das PropertyTagEquipMake-Eigenschaftselement aus dem Image-Objekt , indem seine Image::RemovePropertyItem-Methode aufgerufen wird . Der Code ruft Image::GetPropertyItemSize zweimal auf (einmal vor und einmal nach dem Entfernen des Elements), um die Größe des PropertyTagEquipMake-Eigenschaftselements zu bestimmen. Der Code entfernt das Eigenschaftselement nicht aus der Bilddatei. Das Eigenschaftselement wird nur aus dem Image-Objekt entfernt.
#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;
}
Der vorangehende Code hat zusammen mit einer bestimmten Datei FakePhoto3.jpg die folgende Ausgabe erzeugt:
The size of the PropertyTagEquipMake item is 33.
The size of the PropertyTagEquipMake item is 0.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP, Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | gdiplusheaders.h (include Gdiplus.h) |
| Bibliothek | Gdiplus.lib |
| DLL | Gdiplus.dll |