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 содержит внедренное изображение эскиза, этот метод создает эскиз, масштабируя основное изображение.

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

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