IThumbnailProvider::GetThumbnail-Methode (thumbcache.h)

Artikel
08/26/2023

Ruft ein Miniaturbild und einen Alphatyp ab.

Syntax

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

Parameter

[in] cx

Typ: UINT

Die maximale Miniaturansichtsgröße in Pixel. Die Shell zeichnet die zurückgegebene Bitmap in dieser Größe oder kleiner. Die zurückgegebene Bitmap sollte in ein Quadrat der Breite und Höhe cx passen, obwohl es sich nicht um ein quadratisches Bild handeln muss. Die Shell skaliert die Bitmap so, dass sie bei niedrigeren Größen gerendert wird. Wenn das Bild beispielsweise ein Seitenverhältnis von 6:4 aufweist, sollte die zurückgegebene Bitmap auch ein Seitenverhältnis von 6:4 aufweisen.

[out] phbmp

Typ: HBITMAP*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf das Miniaturbildhandle. Das Bild muss ein DIB-Abschnitt und 32 Bits pro Pixel sein. Die Shell skaliert die Bitmap herunter, wenn ihre Breite oder Höhe größer als die von cx angegebene Größe ist. Die Shell berücksichtigt immer das Seitenverhältnis und skaliert niemals eine Bitmap, die größer als die ursprüngliche Größe ist.

[out] pdwAlpha

Typ: WTS_ALPHATYPE*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf einen der folgenden Werte aus der WTS_ALPHATYPE-Enumeration:

WTSAT_UNKNOWN (0x0)

0x0. Die Bitmap ist ein unbekanntes Format. Die Shell versucht dennoch zu erkennen, ob das Bild über einen Alphakanal verfügt.

WTSAT_RGB (0x1)

0x1. Die Bitmap ist ein RGB-Bild ohne Alpha. Der Alphakanal ist ungültig, und die Shell ignoriert ihn.

WTSAT_ARGB (0x2)

0x2. Die Bitmap ist ein ARGB-Bild mit einem gültigen Alphakanal.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	thumbcache.h

Freigeben über