Image.GetThumbnailImage メソッド

定義

名前空間:

System.Drawing

アセンブリ:

System.Drawing.Common.dll

パッケージ:

System.Drawing.Common v8.0.0

ソース:

Image.cs

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

C#

public System.Drawing.Image GetThumbnailImage (int thumbWidth, int thumbHeight, System.Drawing.Image.GetThumbnailImageAbort? callback, IntPtr callbackData);

パラメーター

thumbWidth

Int32

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

thumbHeight

Int32

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

callback

Image.GetThumbnailImageAbort

Image.GetThumbnailImageAbort デリゲート。

注callback パラメーターには、デリゲートを作成し、そのデリゲートへの参照を渡す必要がありす。ただし、このデリゲートは使用されません。

callbackData

IntPtr

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

戻り値

Image

サムネイルを表す Image。

例

次のコード例では、サムネイル画像を作成して表示します。 このデリゲートは呼び出されません。

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);
}

注釈

に Image 埋め込みサムネイル画像が含まれている場合、このメソッドは埋め込まれたサムネイルを取得し、要求されたサイズにスケーリングします。 にImage埋め込まれたサムネイル画像が含まれていない場合、このメソッドはメインイメージをスケーリングしてサムネイルイメージを作成します。

このメソッドは GetThumbnailImage 、要求されたサムネイル画像のサイズが約 120 x 120 ピクセルの場合に適切に機能します。 サムネイルが埋め込まれている から大きなサムネイル画像 (300 x 300 など) Image を要求すると、サムネイル画像の品質が著しく低下する可能性があります。 メソッドを呼び出して、(埋め込みサムネイルをスケーリングするのではなく) メインイメージをDrawImageスケーリングすることをお勧めします。

適用対象