Image::GetPropertyIdList メソッド (gdiplusheaders.h)

Image::GetPropertyIdList メソッドは、この Image オブジェクトのメタデータで使用されるプロパティ識別子の一覧を取得します。

構文

Status GetPropertyIdList(
  [in]  UINT   numOfProperty,
  [out] PROPID *list
);

パラメーター

[in] numOfProperty

型: UINT

リスト配列内の要素の数を指定する整数。 この番号を確認するには、 Image::GetPropertyCount メソッドを呼び出します。

[out] list

型: PROPID*

プロパティ識別子を受け取る配列へのポインター。

戻り値

種類: 状態

メソッドが成功した場合は、 Status 列挙の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

注釈

Image::GetPropertyIdList メソッドは PROPIDの配列を返します。 Image::GetPropertyIdList を呼び出す前に、その配列を受け取るのに十分な大きさのバッファーを割り当てる必要があります。 Image オブジェクトの Image::GetPropertyCount メソッドを呼び出して、必要なバッファーのサイズを決定できます。 バッファーのサイズは、 Image::GetPropertyCount に sizeof( PROPID) を乗算した戻り値にする必要があります。

例

次の例では、JPEG ファイルに基づいて Image オブジェクトを作成します。 このコードでは、その Image オブジェクトの Image::GetPropertyIdList メソッドを呼び出して、イメージに格納されているメタデータの種類を確認します。

#include <windows.h>
#include <gdiplus.h>
#include <stdio.h>
using namespace Gdiplus;

INT main()
{
   GdiplusStartupInput gdiplusStartupInput;
   ULONG_PTR gdiplusToken;
   GdiplusStartup(&gdiplusToken, &gdiplusStartupInput, NULL);

   UINT count = 0; 
   Image* image = new Image(L"FakePhoto.jpg");

   // How many types of metadata are in the image?
   count = image->GetPropertyCount();
   if(count == 0)
      return 0;

   // Allocate a buffer to receive an array of PROPIDs.
   PROPID* propIDs = new PROPID[count];

   image->GetPropertyIdList(count, propIDs);

   // List the retrieved IDs.
   for(UINT j = 0; j < count; ++j)
      printf("%x\n", propIDs[j]);

   delete [] propIDs;
   delete image;   
  
   GdiplusShutdown(gdiplusToken);
   return 0;
}

上記のコードは、特定のファイルと共に FakePhoto.jpg、次の出力を生成しました。

320
10f
110
9003
829a
5090
5091

上記の出力は、各プロパティ識別子の 16 進数の値を示しています。 Gdiplusimaging.h でこれらの数値を調べて、次のプロパティ タグを表していることを確認できます。

要件

こちらもご覧ください

Image

Image::GetAllPropertyItems

Image::GetPropertyCount

Image::GetPropertyItem

Image::GetPropertyItemSize

Image::GetPropertySize

Image::RemovePropertyItem

Image::SetPropertyItem

PropertyItem

メタデータの読み取りと書き込み