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 |