Метод Image::SetPropertyItem (gdiplusheaders.h)

Метод Image::SetPropertyItem задает элемент свойства (часть метаданных) для этого объекта Image . Если элемент уже существует, его содержимое обновляется; в противном случае добавляется новый элемент.

Синтаксис

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

Параметры

[in] item

Тип: const PropertyItem*

Указатель на объект PropertyItem , указывающий элемент свойства, который необходимо задать.

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Комментарии

Некоторые форматы изображений (например, ICON и EMF) не поддерживают свойства. При вызове метода Image::SetPropertyItem для образа, который не поддерживает свойства, возвращается свойствоNotSupported.

Примеры

Следующее консольное приложение создает объект Image на основе JPEG-файла. Код вызывает метод Image::SetPropertyItem этого объекта Image , чтобы задать заголовок изображения. Затем код извлекает и отображает новый заголовок.

#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;
}

Требования

Требование Значение
Минимальная версия клиента Windows XP, Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header gdiplusheaders.h (включая Gdiplus.h)
Библиотека Gdiplus.lib
DLL Gdiplus.dll

См. также раздел

Изображение

Image::GetPropertyCount

Image::GetPropertyIdList

Image::GetPropertyItem

Image::GetPropertyItemSize

Image::GetPropertySize

Image::RemovePropertyItem

PropertyItem

Чтение и запись метаданных