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) |