Метод 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 |