SHGetImageList-Funktion (shellapi.h)

Ruft eine Bildliste ab.

Syntax

SHSTDAPI SHGetImageList(
  [in]  int    iImageList,
  [in]  REFIID riid,
  [out] void   **ppvObj
);

Parameter

[in] iImageList

Typ: int

Der in der Liste enthaltene Bildtyp. Einer der folgenden Werte:

SHIL_LARGE (0x0)

0x0. Die Bildgröße beträgt normalerweise 32 x 32 Pixel. Wenn jedoch die Option Große Symbole verwenden im Abschnitt Effekte der Registerkarte Darstellung in Anzeigeeigenschaften ausgewählt ist, ist das Bild 48 x 48 Pixel.

SHIL_SMALL (0x1)

0x1. Bei diesen Bildern handelt es sich um die Shell-Standardsymbolgröße 16x16, aber die Größe kann vom Benutzer angepasst werden.

SHIL_EXTRALARGE (0x2)

0x2. Bei diesen Bildern handelt es sich um die standardgroße Shell-Symbolgröße. Dies ist in der Regel 48 x 48, aber die Größe kann vom Benutzer angepasst werden.

SHIL_SYSSMALL (0x3)

0x3. Diese Images sind die von GetSystemMetrics angegebene Größe, die mit SM_CXSMICON und GetSystemMetrics mit SM_CYSMICON aufgerufen wird.

SHIL_JUMBO (0x4)

0x4. Windows Vista und höher. Das Bild ist normalerweise 256 x 256 Pixel.

SHIL_LAST

Der größte gültige Flagwert zu Validierungszwecken.

[in] riid

Typ: REFIID

Verweis auf den Bezeichner der Bildlistenschnittstelle, normalerweise IID_IImageList.

[out] ppvObj

Typ: void**

Wenn diese Methode zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel IImageList.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der IImageList-Zeigertyp , z. B. der im ppv-Parameter zurückgegebene, kann bei Bedarf als HIMAGELIST umgewandelt werden. beispielsweise für die Verwendung in einer Listenansicht. Umgekehrt kann eine HIMAGELIST als Zeiger auf eine IImageList umgewandelt werden.

Ab Windows Vista SHIL_SMALL, SHIL_LARGE und SHIL_EXTRALARGE mit dpi(dots per inch) skalieren, wenn der Prozess als dpi-fähig markiert ist. Um diese Typen auf dpi-fähig festzulegen, rufen Sie SetProcessDPIAware auf. SHIL_JUMBO ist unabhängig von der dpi-fähigen Einstellung auf 256 Pixel festgelegt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shellapi.h
DLL Shell32.dll
APIs ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393)

Weitere Informationen

FileIconInit