IThumbnailProvider：：GetThumbnail 方法 (thumbcache.h)

取得縮圖影像和 Alpha 類型。

語法

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

[in] cx

類型： UINT

縮圖大小上限，以圖元為單位。 Shell 會在此大小或較小處繪製傳回的點陣圖。傳回的點陣圖應該符合寬度和高度 cx的平方，但不需要是正方形影像。 Shell 會縮放點陣圖，以較低的大小呈現。例如，如果影像具有 6：4 外觀比例，則傳回的點陣圖也應該有 6：4 外觀比例。

[out] phbmp

類型： HBITMAP*

當這個方法傳回時，會包含縮圖影像控制碼的指標。影像必須是 DIB 區段，每個圖元 32 位。如果點陣圖的寬度或高度大於 cx所指定的大小，Shell 就會相應減少點陣圖。 Shell 一律會遵守外觀比例，且永遠不會縮放大於其原始大小的點陣圖。

[out] pdwAlpha

類型： WTS_ALPHATYPE*

當這個方法傳回時，會包含下列其中一個值的指標，這些值來自WTS_ALPHATYPE列舉：

0x0。點陣圖是未知的格式。殼層仍會嘗試偵測影像是否有 Alpha 色板。

0x1。點陣圖是不含 Alpha 的 RGB 影像。 Alpha 色板無效，且殼層會忽略它。

0x2。點陣圖是具有有效 Alpha 色板的 ARGB 影像。

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。