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

  • [アーティクル]

Image::GetThumbnailImage メソッドは、この Image オブジェクトからサムネイル画像を取得します。

構文

Image * GetThumbnailImage(
  [in] UINT                   thumbWidth,
  [in] UINT                   thumbHeight,
  [in] GetThumbnailImageAbort callback,
       VOID                   *callbackData
);

パラメーター

[in] thumbWidth

型: UINT

要求されたサムネイル画像の幅 (ピクセル単位)。

[in] thumbHeight

型: UINT

要求されたサムネイル画像の高さ (ピクセル単位)。

[in] callback

型: GetThumbnailImageAbort

省略可能。 指定したコールバック関数。 サムネイル イメージを作成または取得するプロセス中に、GDI+ はこの関数を呼び出して、プロセスを中止する機会を提供します。 既定値は NULL です。

callbackData

型: VOID*

省略可能。 コールバック関数で使用されるデータを含むメモリ ブロックへのポインター。 既定値は NULL です。

戻り値

種類: イメージ*

このメソッドは、サムネイル画像を含む Image オブジェクトへのポインターを返します。

解説

サムネイル画像は、画像の小さなコピーです。 一部の画像ファイルには、ファイルにサムネイル画像が埋め込まれています。 このような場合、このメソッドは埋め込まれたサムネイル画像を取得します。 埋め込まれたサムネイル画像がない場合、このメソッドは、thumbWidth パラメーターと thumbHeight パラメーターで指定されたサイズにメインイメージをスケーリングしてサムネイルイメージを作成します。 これらのパラメーターの両方が 0 の場合は、システム定義のサイズが使用されます。

例

次の例では、JPEG ファイルに基づいて Image オブジェクトを作成します。 このコードは、その Image オブジェクトの Image::GetThumbnailImage メソッドを呼び出し、サムネイル画像とメインイメージを表示します。

VOID Example_GetThumbnail(HDC hdc)
{
   Graphics graphics(hdc);

   // Create an image and a thumbnail of the image.
   Image image(L"Crayons.jpg");
   Image* pThumbnail = image.GetThumbnailImage(40, 40, NULL, NULL);

   // Draw the original and the thumbnail images.
   graphics.DrawImage(&image, 10, 10, image.GetWidth(), image.GetHeight());
   graphics.DrawImage(
      pThumbnail, 
      150, 
      10, 
      pThumbnail->GetWidth(), 
      pThumbnail->GetHeight());

   delete pThumbnail;

}

要件

   
サポートされている最小のクライアント Windows XP、Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー gdiplusheaders.h (Gdiplus.h を含む)
Library Gdiplus.lib
[DLL] Gdiplus.dll

関連項目

Bitmap

サムネイル画像の作成

イメージ

イメージ、ビットマップ、メタファイル