Image：：RemovePropertyItem 方法 (gdiplusheaders.h)

發行項
08/24/2023

Image：：RemovePropertyItem方法會從這個Image物件中移除屬性專案 (部分中繼資料) 。

語法

Status RemovePropertyItem(
  [in] PROPID propId
);

參數

[in] propId

類型： PROPID

整數，識別要移除的屬性專案。

傳回值

類型：狀態

如果方法成功，它會傳回 Ok，這是 Status 列舉的元素。

如果方法失敗，它會傳回 Status 列舉的其他其中一個專案。

備註

Image：：RemovePropertyItem方法會從Image物件中移除指定的屬性，但該屬性專案不會從用來建構Image物件的檔案或資料流程中移除。若要將影像 (，並將屬性專案移除) 儲存至新的 JPEG 檔案或資料流程，請呼叫Image物件的Save方法。

範例

下列範例會根據 JPEG 檔案建立 Image 物件。程式碼會藉由呼叫Image：：RemovePropertyItem方法，從Image物件中移除 PropertyTagEquipMake 屬性專案。程式碼會呼叫 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
標頭	gdiplusheaders.h (包含 Gdiplus.h)
程式庫	Gdiplus.lib
Dll	Gdiplus.dll