Image：：SetPropertyItem 方法 (gdiplusheaders.h)

项目
03/05/2024

Image：：SetPropertyItem 方法 (此 Image 对象的元数据) 段设置属性项。如果该项已存在，则更新其内容;否则，将添加新项。

语法

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

参数

[in] item

类型： const PropertyItem*

指向 PropertyItem 对象的指针，该对象指定要设置的属性项。

返回值

类型：状态

如果该方法成功，则返回 Ok，这是 Status 枚举的元素。

如果方法失败，它将返回 Status 枚举的其他元素之一。

注解

某些图像格式 (例如 ICON 和 EMF) 不支持属性。如果在不支持属性的图像上调用 Image：：SetPropertyItem 方法，它将返回 PropertyNotSupported。

示例

以下控制台应用程序基于 JPEG 文件创建 Image 对象。代码调用该 Image 对象的 Image：：SetPropertyItem 方法来设置图像的标题。然后，代码检索并显示新标题。

#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
标头	gdiplusheaders.h (包括 Gdiplus.h)
Library	Gdiplus.lib
DLL	Gdiplus.dll