SHGetImageList-Funktion (shellapi.h)

Ruft eine Bildliste ab.

Syntax

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

Die 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 die Option "Große Symbole verwenden " jedoch im Abschnitt "Effekte " der Registerkarte " Darstellung " in den Anzeigeeigenschaften ausgewählt ist, beträgt das Bild 48 x 48 Pixel.

SHIL_SMALL (0x1)

0x1. Diese Bilder sind die standardmäßige kleine Symbolgröße der Shell von 16 x 16, aber die Größe kann vom Benutzer angepasst werden.

SHIL_EXTRALARGE (0x2)

0x2. Diese Bilder sind die standardmäßige extra große Symbolgröße der Shell. Dies ist in der Regel 48 x 48, aber die Größe kann vom Benutzer angepasst werden.

SHIL_SYSSMALL (0x3)

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

SHIL_JUMBO (0x4)

0x4. Windows Vista und höher. Das Bild beträgt normalerweise 256 x 256 Pixel.

SHIL_LAST

Der größte gültige Flagwert für Überprüfungszwecke.

[in] riid

Typ: REFIID

Verweisen auf den Bezeichner der Bildlistenschnittstelle, normalerweise IID_IImageList.

[out] ppvObj

Typ: void**

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

Rückgabewert

Typ: HRESULT-

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

Bemerkungen

Der IImageList-Zeigertyp , z. B. der im ppv-Parameter zurückgegeben wird, kann nach Bedarf als HIMAGELIST umgewandelt werden; Zum Beispiel für die Verwendung in einer Listenansicht. Umgekehrt kann eine HIMAGELIST als Zeiger auf eine IImageList umzustellen.

Ab Windows Vista SHIL_SMALL, SHIL_LARGE und SHIL_EXTRALARGE mit Punkten pro Zoll (dpi) skaliert, wenn der Prozess als dpi-fähig gekennzeichnet ist. Rufen Sie SetProcessDPIAware auf, um diese Typen auf dpi-fähig festzulegen. SHIL_JUMBO wird unabhängig von der dpi-fähigen Einstellung auf 256 Pixel festgelegt.

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows XP [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform	Fenster
Header	shellapi.h
Library	OneCore.Lib
DLL	Shell32.dll
API-Satz	ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393)

Siehe auch

FileIconInit