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;
}
요구 사항
지원되는 최소 클라이언트 | Windows XP, Windows 2000 Professional [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | gdiplusheaders.h(Gdiplus.h 포함) |
라이브러리 | Gdiplus.lib |
DLL | Gdiplus.dll |