IThumbnailProvider::GetThumbnail 메서드(thumbcache.h)

아티클
08/26/2023

썸네일 이미지 및 알파 형식을 가져옵니다.

구문

HRESULT GetThumbnail(
  [in]  UINT          cx,
  [out] HBITMAP       *phbmp,
  [out] WTS_ALPHATYPE *pdwAlpha
);

매개 변수

[in] cx

형식: UINT

최대 썸네일 크기(픽셀)입니다. 셸은 반환된 비트맵을 이 크기 또는 더 작은 크기로 그립니다. 반환된 비트맵은 정사각형 이미지일 필요는 없지만 너비 및 높이 cx의 제곱에 맞아야 합니다. Shell은 비트맵의 크기를 조정하여 더 낮은 크기로 렌더링합니다. 예를 들어 이미지의 가로 세로 비율이 6:4이면 반환된 비트맵에도 6:4 가로 세로 비율이 있어야 합니다.

[out] phbmp

형식: HBITMAP*

이 메서드가 반환되면 썸네일 이미지 핸들에 대한 포인터가 포함됩니다. 이미지는 DIB 섹션과 픽셀당 32비트여야 합니다. 너비 또는 높이가 cx로 지정된 크기보다 큰 경우 셸은 비트맵을 축소합니다. 셸은 항상 가로 세로 비율을 준수하며 원래 크기보다 큰 비트맵의 크기를 조정하지 않습니다.

[out] pdwAlpha

형식: WTS_ALPHATYPE*

이 메서드가 반환되면 WTS_ALPHATYPE 열거형의 다음 값 중 하나에 대한 포인터가 포함됩니다.

WTSAT_UNKNOWN(0x0)

0x0. 비트맵은 알 수 없는 형식입니다. 그럼에도 불구하고 셸은 이미지에 알파 채널이 있는지 여부를 감지하려고 시도합니다.

WTSAT_RGB(0x1)

0x1. 비트맵은 알파가 없는 RGB 이미지입니다. 알파 채널이 잘못되었으며 셸에서 이를 무시합니다.

WTSAT_ARGB(0x2)

0x2. 비트맵은 유효한 알파 채널이 있는 ARGB 이미지입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 성공하지 않으면 HRESULT 오류 코드를 반환합니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	thumbcache.h

다음을 통해 공유