Метод Image::RemovePropertyItem (gdiplusheaders.h)
Метод Image::RemovePropertyItem удаляет элемент свойства (часть метаданных) из этого объекта Image .
Синтаксис
Status RemovePropertyItem(
[in] PROPID propId
);
Параметры
[in] propId
Тип: PROPID
Целое число, определяющее удаляемый элемент свойства.
Возвращаемое значение
Тип: Состояние
В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .
Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .
Комментарии
Метод Image::RemovePropertyItem удаляет указанное свойство из объекта Image , но этот элемент свойства не удаляется из файла или потока, который использовался для создания объекта Image . Чтобы сохранить изображение (с удаленным элементом свойства) в новый JPEG-файл или поток, вызовите метод Save объекта Image .
Примеры
В следующем примере создается объект Image на основе JPEG-файла. Код удаляет элемент свойства PropertyTagEquipMake из объекта Image путем вызова его метода Image::RemovePropertyItem . Код вызывает Image::GetPropertyItemSize дважды (один раз до и один раз после удаления элемента), чтобы определить размер элемента свойства PropertyTagEquipMake. Код не удаляет элемент свойства из файла изображения; Удаляет элемент свойства только из объекта 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;
}
Приведенный выше код вместе с определенным файлом FakePhoto3.jpg выводятся следующие выходные данные:
The size of the PropertyTagEquipMake item is 33.
The size of the PropertyTagEquipMake item is 0.
Требования
| Минимальная версия клиента | Windows XP, Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | gdiplusheaders.h (включая Gdiplus.h) |
| Библиотека | Gdiplus.lib |
| DLL | Gdiplus.dll |