Funzione SHGetImageList (shellapi.h)

Articolo
03/15/2023

Recupera un elenco di immagini.

Sintassi

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

Parametri

[in] iImageList

Tipo: int

Tipo di immagine contenuto nell'elenco. Uno dei valori seguenti:

SHIL_LARGE (0x0)

0x0. Le dimensioni dell'immagine sono in genere di 32x32 pixel. Tuttavia, se l'opzione Usa icone di grandi dimensioni è selezionata nella sezione Effetti della scheda Aspetto in Proprietà visualizzazione, l'immagine è 48x48 pixel.

SHIL_SMALL (0x1)

0x1. Queste immagini sono le dimensioni standard dell'icona shell di 16x16, ma le dimensioni possono essere personalizzate dall'utente.

SHIL_EXTRALARGE (0x2)

0x2. Queste immagini sono le dimensioni dell'icona standard della shell extra-large. Si tratta in genere di 48x48, ma le dimensioni possono essere personalizzate dall'utente.

SHIL_SYSSMALL (0x3)

0x3. Queste immagini sono le dimensioni specificate da GetSystemMetrics chiamate con SM_CXSMICON e GetSystemMetrics chiamate con SM_CYSMICON.

SHIL_JUMBO (0x4)

0x4. Windows Vista e versioni successive. L'immagine è in genere 256x256 pixel.

SHIL_LAST

Valore di flag valido più grande, a scopo di convalida.

[in] riid

Tipo: REFIID

Riferimento all'identificatore dell'interfaccia dell'elenco di immagini, in genere IID_IImageList.

[out] ppvObj

Tipo: void**

Quando termina, questo metodo contiene il puntatore di interfaccia richiesto in riid. Si tratta in genere di IImageList.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il tipo di puntatore IImageList , ad esempio quello restituito nel parametro ppv , può essere sottoposto a cast come HIMAGELIST in base alle esigenze; ad esempio, per l'uso in una visualizzazione elenco. Al contrario, un HIMAGELIST può essere eseguito come puntatore a un oggetto IImageList.

A partire da Windows Vista, SHIL_SMALL, SHIL_LARGE e SHIL_EXTRALARGE scala con punti per pollice (dpi) se il processo è contrassegnato come compatibile con dpi. Per impostare questi tipi in modo che siano compatibili con dpi, chiamare SetProcessDPIAware. SHIL_JUMBO è fisso a 256 pixel indipendentemente dall'impostazione con riconoscimento dpi.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shellapi.h
DLL	Shell32.dll
Set di API	ext-ms-win-shell-shell32-l1-2-2 (introdotto in Windows 10, versione 10.0.14393)

Vedi anche

FileIconInit

Condividi tramite