Metodo IThumbnailProvider::GetThumbnail (thumbcache.h)

Ottiene un'immagine di anteprima e un tipo alfa.

Sintassi

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

Parametri

[in] cx

Tipo: UINT

Dimensioni massime dell'anteprima, in pixel. La shell disegna la bitmap restituita in base a questa dimensione o inferiore. La bitmap restituita deve essere adattata a un quadrato di larghezza e altezza cx, anche se non deve essere un'immagine quadrata. Shell ridimensiona la bitmap per eseguire il rendering con dimensioni inferiori. Ad esempio, se l'immagine ha proporzioni 6:4, anche la bitmap restituita deve avere proporzioni 6:4.

[out] phbmp

Tipo: HBITMAP*

Quando termina, questo metodo contiene un puntatore all'handle dell'immagine di anteprima. L'immagine deve essere una sezione DIB e 32 bit per pixel. La shell riduce la bitmap se la larghezza o l'altezza è maggiore della dimensione specificata da cx. Shell rispetta sempre le proporzioni e non ridimensiona mai una bitmap superiore alla dimensione originale.

[out] pdwAlpha

Tipo: WTS_ALPHATYPE*

Quando termina, questo metodo contiene un puntatore a uno dei valori seguenti dell'enumerazione WTS_ALPHATYPE:

WTSAT_UNKNOWN (0x0)

0x0. La bitmap è un formato sconosciuto. Shell tenta comunque di rilevare se l'immagine ha un canale alfa.

WTSAT_RGB (0x1)

0x1. La bitmap è un'immagine RGB senza alfa. Il canale alfa non è valido e shell lo ignora.

WTSAT_ARGB (0x2)

0x2. La bitmap è un'immagine ARGB con un canale alfa valido.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	thumbcache.h