Image.GetThumbnailImage Метод

Определение

Возвращает эскиз для этого объекта 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);
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, представляющий эскиз.

Примеры

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

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 метод .

Применяется к