Image.GetThumbnailImage メソッド
この Image オブジェクトのサムネイルを返します。
Public Function GetThumbnailImage( _
ByVal thumbWidth As Integer, _ ByVal thumbHeight As Integer, _ ByVal callback As Image.GetThumbnailImageAbort, _ ByVal callbackData As IntPtr _) As Image
[C#]
public Image GetThumbnailImage(intthumbWidth,intthumbHeight,Image.GetThumbnailImageAbortcallback,IntPtrcallbackData);
[C++]
public: Image* GetThumbnailImage(intthumbWidth,intthumbHeight,Image.GetThumbnailImageAbort* callback,IntPtrcallbackData);
[JScript]
public function GetThumbnailImage(
thumbWidth : int,thumbHeight : int,callback : Image.GetThumbnailImageAbort,callbackData : IntPtr) : Image;
パラメータ
- thumbWidth
要求されたサムネイル イメージの幅 (ピクセル単位)。 - thumbHeight
要求されたサムネイル イメージの高さ (ピクセル単位)。 - callback
Image.GetThumbnailImageAbort デリゲート。GDI+ バージョン 1.0 ではデリゲートは使用されません。その場合でもデリゲートを作成し、作成したデリゲートへの参照をこのパラメータに渡す必要があります。 - callbackData
IntPtr.Zero にする必要があります。
戻り値
サムネイルを表す Image オブジェクト。
解説
Image オブジェクトに埋め込みサムネイル イメージが含まれる場合、このメソッドは、埋め込みサムネイルを取り出して要求されたサイズに変更します。 Image オブジェクトに埋め込みサムネイル イメージが含まれない場合、このメソッドは、元のイメージのサイズを変更してサムネイル イメージを作成します。
GetThumbnailImage は、要求されたサムネイル イメージのサイズが 120 x 120 程度の場合に効率よく処理を行います。埋め込みサムネイルが含まれる Image オブジェクトからサイズの大きいサムネイル イメージ (300 x 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);
}
[Visual Basic, C++, JScript] Visual Basic、C++、および JScript のサンプルはありません。C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ