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 Bildtyp, der in der Liste enthalten ist. Einer der folgenden Werte:
SHIL_LARGE (0x0)
0x0. Die Bildgröße beträgt normalerweise 32x32 Pixel. Wenn die Option "Große Symbole verwenden " jedoch aus dem Abschnitt "Effekte " der Registerkarte "Darstellung " in den Anzeigeeigenschaften ausgewählt ist, ist das Bild 48x48 Pixel.
SHIL_SMALL (0x1)
0x1. Diese Bilder sind die Standardsymbolgröße von 16x16, aber die Größe kann vom Benutzer angepasst werden.
SHIL_EXTRALARGE (0x2)
0x2. Diese Bilder sind die Standardgröße für extra große Symbole der Shell. Dies ist in der Regel 48x48, aber die Größe kann vom Benutzer angepasst werden.
SHIL_SYSSMALL (0x3)
0x3. Diese Bilder sind die Größe, die von GetSystemMetrics angegeben wird, 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 ist normalerweise 256x256 Pixel.
SHIL_LAST
Der größte gültige Flagwert für Validierungszwecke.
[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 der in riid angeforderte Schnittstellenzeiger. Dies ist in der Regel IImageList.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich verläuft, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Hinweise
Der IImageList-Zeigertyp , z. B. der im PPV-Parameter zurückgegebene Typ, kann nach Bedarf als HIMAGELIST gecastet werden; Zum Beispiel für die Verwendung in einer Listenansicht. Umgekehrt kann eine HIMAGELIST als Zeiger auf eine IImageList gecastt werden.
Ab Windows Vista werden SHIL_SMALL ,SHIL_LARGE und SHIL_EXTRALARGE mit Punkt pro Zoll (dpi) skaliert, wenn der Prozess als dpi-fähig gekennzeichnet ist. Um diese Typen auf dpi-fähig festzulegen, rufen Sie SetProcessDPIAware auf. SHIL_JUMBO wird unabhängig von der dpi-fähigen Einstellung auf 256 Pixel behoben.
Anforderungen
| 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-shell32-l1-2-2(eingeführt in Windows 10, Version 10.0.14393) |