IThumbnailProvider::GetThumbnail メソッド (thumbcache.h)

サムネイル画像とアルファの種類を取得します。

構文

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

パラメーター

[in] cx

型: UINT

サムネイルの最大サイズ (ピクセル単位)。 シェルは、返されたビットマップをこのサイズ以下で描画します。 返されるビットマップは、幅と高さ cx の 2 乗に収まる必要がありますが、正方形のイメージである必要はありません。 シェルはビットマップをスケーリングして、より小さいサイズでレンダリングします。 たとえば、イメージの縦横比が 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 エラー コードを返します。

要件