Image.GetThumbnailImage Метод

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

Исходный код:

Image.cs

Возвращает эскиз для этого объекта Image.

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

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

member this.GetThumbnailImage : int * int * System.Drawing.Image.GetThumbnailImageAbort * nativeint -> System.Drawing.Image

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

Параметры

thumbWidth

Int32

Ширина изображения запрашиваемого эскиза в пикселях.

thumbHeight

Int32

Высота изображения запрашиваемого эскиза в пикселях.

callback

Image.GetThumbnailImageAbort

Делегат Image.GetThumbnailImageAbort.

Примечание. Необходимо создать делегат и передать ссылку на него в виде параметра callback, но сам делегат не используется.

callbackData

IntPtr

nativeint

Этот параметр должен содержать значение Zero.

Возвращаемое значение

Image

Объект Image, представляющий эскиз.

Примеры

В следующем примере кода создается и отображается эскиз изображения. Этот делегат никогда не вызывается.

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

Public Function ThumbnailCallback() As Boolean 
  Return False 
End Function 

Public Sub Example_GetThumb(ByVal e As PaintEventArgs) 
    Dim myCallback As New Image.GetThumbnailImageAbort(AddressOf ThumbnailCallback) 
    Dim myBitmap As New Bitmap("Climber.jpg") 
    Dim myThumbnail As Image = myBitmap.GetThumbnailImage(40, 40, myCallback, IntPtr.Zero) 
    e.Graphics.DrawImage(myThumbnail, 150, 75) 
End Sub

Комментарии

Image Если содержит внедренное изображение эскиза, этот метод извлекает внедренный эскиз и масштабирует его до запрошенного размера. Image Если не содержит внедренного эскиза, этот метод создает эскиз путем масштабирования main изображения.

Метод GetThumbnailImage хорошо работает, если запрошенное эскизное изображение имеет размер около 120 x 120 пикселей. При запросе большого эскиза (например, 300 x 300) из Image объекта с внедренным эскизом может произойти заметное снижение качества эскиза. Возможно, лучше масштабировать main изображение (вместо масштабирования внедренного эскиза), вызвав DrawImage метод .