Image.GetThumbnailImage メソッド

.NET Framework クラス ライブラリ リファレンス

Image.GetThumbnailImage メソッド

この Image のサムネイルを返します。

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Function GetThumbnailImage ( _
    thumbWidth As Integer, _
    thumbHeight As Integer, _
    callback As GetThumbnailImageAbort, _
    callbackData As IntPtr _
) As Image

Visual Basic (使用法)

Dim instance As Image
Dim thumbWidth As Integer
Dim thumbHeight As Integer
Dim callback As GetThumbnailImageAbort
Dim callbackData As IntPtr
Dim returnValue As Image

returnValue = instance.GetThumbnailImage(thumbWidth, thumbHeight, callback, callbackData)

C#

public Image GetThumbnailImage (
    int thumbWidth,
    int thumbHeight,
    GetThumbnailImageAbort callback,
    IntPtr callbackData
)

C++

public:
Image^ GetThumbnailImage (
    int thumbWidth, 
    int thumbHeight, 
    GetThumbnailImageAbort^ callback, 
    IntPtr callbackData
)

J#

public Image GetThumbnailImage (
    int thumbWidth, 
    int thumbHeight, 
    GetThumbnailImageAbort callback, 
    IntPtr callbackData
)

JScript

public function GetThumbnailImage (
    thumbWidth : int, 
    thumbHeight : int, 
    callback : GetThumbnailImageAbort, 
    callbackData : IntPtr
) : Image

パラメータ

thumbWidth

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

thumbHeight

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

callback

Image.GetThumbnailImageAbort デリゲート。GDI+ Version 1.0 ではデリゲートは使用されません。その場合でもデリゲートを作成し、作成したデリゲートへの参照をこのパラメータに渡す必要があります。

callbackData

Zero にする必要があります。

戻り値
サムネイルを表す Image。

解説

Image に埋め込みサムネイル イメージが含まれる場合、このメソッドは、埋め込みサムネイルを取り出して要求されたサイズに変更します。Image に埋め込みサムネイル イメージが含まれない場合、このメソッドは、元のイメージのサイズを変更してサムネイル イメージを作成します。

GetThumbnailImage メソッドは、要求されたサムネイル イメージのサイズが 120 × 120 ピクセル程度の場合に効率よく処理を行います。埋め込みサムネイルが含まれる Image からサイズの大きいサムネイル イメージ (たとえば、300 × 300) を作成するように要求した場合、サムネイル イメージの画質はかなり低下します。この場合は、DrawImage メソッドを呼び出して、元のイメージのサイズを変更した方が、埋め込みサムネイルのサイズを変更するよりも高い画質を得られます。

使用例

サムネイル イメージを作成し表示するコード例を次に示します。このデリゲートが呼び出されることはありません。

C#

public bool ThumbnailCallback()
 {
 return false;
 }
 public void Example_GetThumb(PaintEventArgs
 e)
 {
 Image.GetThumbnailImageAbort myCallback =
 new Image.GetThumbnailImageAbort(ThumbnailCallback);
 Bitmap myBitmap = new Bitmap("Climber.jpg");
 Image myThumbnail = myBitmap.GetThumbnailImage(
 40, 40, myCallback, IntPtr.Zero);
 e.Graphics.DrawImage(myThumbnail, 150, 75);
 }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Image クラス
Image メンバ
System.Drawing 名前空間