Metodo Image::SetPropertyItem (gdiplusheaders.h)

Articolo
03/05/2024

Il metodo Image::SetPropertyItem imposta un elemento della proprietà (parte di metadati) per questo oggetto Image . Se l'elemento esiste già, il relativo contenuto viene aggiornato; in caso contrario, viene aggiunto un nuovo elemento.

Sintassi

Status SetPropertyItem(
  [in] const PropertyItem *item
);

Parametri

[in] item

Tipo: const PropertyItem*

Puntatore a un oggetto PropertyItem che specifica l'elemento della proprietà da impostare.

Valore restituito

Tipo: Stato

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

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

Commenti

Alcuni formati di immagine (ad esempio ICON e EMF) non supportano le proprietà. Se chiami il metodo Image::SetPropertyItem su un'immagine che non supporta le proprietà, restituirà PropertyNotSupported.

Esempio

L'applicazione console seguente crea un oggetto Image basato su un file JPEG. Il codice chiama il metodo Image::SetPropertyItem dell'oggetto Image per impostare il titolo dell'immagine. Il codice recupera e visualizza quindi il nuovo titolo.

#include <windows.h>
#include <gdiplus.h>
#include <stdio.h>
using namespace Gdiplus;

INT main()
{
   GdiplusStartupInput gdiplusStartupInput;
   ULONG_PTR gdiplusToken;
   GdiplusStartup(&gdiplusToken, &gdiplusStartupInput, NULL);

   // Create an Image object based on a JPEG file.
   Image* image = new Image(L"FakePhoto.jpg");

   // Set the image title.
   PropertyItem* propItem = new PropertyItem;
   CHAR newTitleValue[] = "Fake Photograph 2";

   propItem->id = PropertyTagImageTitle;
   propItem->length = 18;  //  includes null terminator
   propItem->type = PropertyTagTypeASCII;
   propItem->value = newTitleValue;

   image->SetPropertyItem(propItem);

   // Get and display the new image title.
   UINT size = image->GetPropertyItemSize(PropertyTagImageTitle);
   PropertyItem* title = (PropertyItem*)malloc(size);
   image->GetPropertyItem(PropertyTagImageTitle, size, title);
   printf("The image title is %s.\n", title->value);

   free(title);
   delete propItem;
   delete image;
   GdiplusShutdown(gdiplusToken);
   return 0;
}

Requisiti

Requisito	Valore
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