Image::GetThumbnailImage 메서드(gdiplusheaders.h)

Image::GetThumbnailImage 메서드는 이 Image 개체에서 썸네일 이미지를 가져옵니다.

구문

Image * GetThumbnailImage(
  [in] UINT                   thumbWidth,
  [in] UINT                   thumbHeight,
  [in] GetThumbnailImageAbort callback,
       VOID                   *callbackData
);

매개 변수

[in] thumbWidth

형식: UINT

요청된 썸네일 이미지의 너비(픽셀)입니다.

[in] thumbHeight

형식: UINT

요청된 썸네일 이미지의 높이(픽셀)입니다.

[in] callback

형식: GetThumbnailImageAbort

(선택 사항) 제공하는 콜백 함수입니다. 썸네일 이미지를 만들거나 검색하는 과정에서 GDI+는 이 함수를 호출하여 프로세스를 중단할 수 있는 기회를 제공합니다. 기본값은 NULL입니다.

callbackData

형식: VOID*

(선택 사항) 콜백 함수에서 사용할 데이터가 포함된 메모리 블록에 대한 포인터입니다. 기본값은 NULL입니다.

반환 값

형식: 이미지*

이 메서드는 썸네일 이미지를 포함하는 Image 개체에 대한 포인터를 반환합니다.

설명

썸네일 이미지는 이미지의 작은 복사본입니다. 일부 이미지 파일에는 썸네일 이미지가 파일에 포함되어 있습니다. 이러한 경우 이 메서드는 포함된 썸네일 이미지를 검색합니다. 포함된 썸네일 이미지가 없는 경우 이 메서드는 thumbWidth 및 thumbHeight 매개 변수에 지정된 크기로 기본 이미지를 크기 조정하여 썸네일 이미지를 만듭니다. 두 매개 변수가 모두 0이면 시스템 정의 크기가 사용됩니다.

예제

다음 예제에서는 JPEG 파일을 기반으로 Image 개체를 만듭니다. 코드는 해당 Image 개체의 Image::GetThumbnailImage 메서드를 호출한 다음 기본 이미지와 함께 썸네일 이미지를 표시합니다.

VOID Example_GetThumbnail(HDC hdc)
{
   Graphics graphics(hdc);

   // Create an image and a thumbnail of the image.
   Image image(L"Crayons.jpg");
   Image* pThumbnail = image.GetThumbnailImage(40, 40, NULL, NULL);

   // Draw the original and the thumbnail images.
   graphics.DrawImage(&image, 10, 10, image.GetWidth(), image.GetHeight());
   graphics.DrawImage(
      pThumbnail, 
      150, 
      10, 
      pThumbnail->GetWidth(), 
      pThumbnail->GetHeight());

   delete pThumbnail;

}

요구 사항

참고 항목

Bitmap

썸네일 이미지 만들기

이미지

이미지, 비트맵 및 메타파일