Partager via


Image::RemovePropertyItem, méthode (gdiplusheaders.h)

La méthode Image::RemovePropertyItem supprime un élément de propriété (morceau de métadonnées) de cet objet Image .

Syntaxe

Status RemovePropertyItem(
  [in] PROPID propId
);

Paramètres

[in] propId

Type : PROPID

Entier qui identifie l’élément de propriété à supprimer.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Notes

La méthode Image::RemovePropertyItem supprime une propriété spécifiée d’un objet Image , mais cet élément de propriété n’est pas supprimé du fichier ou du flux qui a été utilisé pour construire l’objet Image . Pour enregistrer l’image (avec l’élément de propriété supprimé) dans un nouveau fichier ou flux JPEG, appelez la méthode Save de l’objet Image .

Exemples

L’exemple suivant crée un objet Image basé sur un fichier JPEG. Le code supprime l’élément de propriété PropertyTagEquipMake de l’objet Image en appelant sa méthode Image::RemovePropertyItem . Le code appelle Image::GetPropertyItemSize deux fois (une fois avant et une fois après la suppression de l’élément) pour déterminer la taille de l’élément de propriété PropertyTagEquipMake. Le code ne supprime pas l’élément de propriété du fichier image ; il supprime l’élément de propriété uniquement de l’objet 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;
}

Le code précédent, ainsi qu’un fichier particulier, FakePhoto3.jpg, ont produit la sortie suivante :

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

Configuration requise

   
Client minimal pris en charge Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête gdiplusheaders.h (inclure Gdiplus.h)
Bibliothèque Gdiplus.lib
DLL Gdiplus.dll

Voir aussi

Image

Image::GetAllPropertyItems

Image::GetPropertyCount

Image::GetPropertyIdList

Image::GetPropertyItem

Image::GetPropertyItemSize

Image::GetPropertySize

Image::SetPropertyItem

PropertyItem

Lecture et écriture de métadonnées