Méthode IThumbnailProvider::GetThumbnail (thumbcache.h)

Article
08/26/2023

Obtient une image miniature et un type alpha.

Syntaxe

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

Paramètres

[in] cx

Type : UINT

Taille de miniature maximale, en pixels. L’interpréteur de commandes dessine la bitmap retournée à cette taille ou à une taille inférieure. La bitmap retournée doit tenir dans un carré de largeur et de hauteur cx, bien qu’il n’ait pas besoin d’être une image carrée. L’interpréteur de commandes met à l’échelle la bitmap pour qu’elle s’affiche à des tailles inférieures. Par exemple, si l’image a des proportions de 6:4, la bitmap retournée doit également avoir un rapport de 6:4.

[out] phbmp

Type : HBITMAP*

Lorsque cette méthode est retournée, contient un pointeur vers le handle d’image miniature. L’image doit être une section DIB et 32 bits par pixel. L’interpréteur de commandes effectue un scale-down de la bitmap si sa largeur ou sa hauteur est supérieure à la taille spécifiée par cx. L’interpréteur de commandes respecte toujours les proportions et ne met jamais à l’échelle une bitmap plus grande que sa taille d’origine.

[out] pdwAlpha

Type : WTS_ALPHATYPE*

Lorsque cette méthode est retournée, contient un pointeur vers l’une des valeurs suivantes de l’énumération WTS_ALPHATYPE :

WTSAT_UNKNOWN (0x0)

0x0. La bitmap est un format inconnu. L’interpréteur de commandes tente néanmoins de détecter si l’image a un canal alpha.

WTSAT_RGB (0x1)

0x1. La bitmap est une image RVB sans alpha. Le canal alpha n’est pas valide et l’interpréteur de commandes l’ignore.

WTSAT_ARGB (0x2)

0x2. La bitmap est une image ARGB avec un canal alpha valide.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	thumbcache.h

Partager via