Image::RemovePropertyItem-Methode (gdiplusheaders.h)

Artikel
08/24/2023

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