Funzione ImageList_Create (commctrl.h)

Crea un nuovo elenco di immagini.

Sintassi

HIMAGELIST ImageList_Create(
  int  cx,
  int  cy,
  UINT flags,
  int  cInitial,
  int  cGrow
);

Parametri

cx

Tipo: int

Larghezza, in pixel, di ogni immagine.

cy

Tipo: int

Altezza, in pixel, di ogni immagine.

flags

Tipo: UINT

Set di flag di bit che specificano il tipo di elenco di immagini da creare. Questo parametro può essere una combinazione dei flag di creazione dell'elenco di immagini.

cInitial

Tipo: int

Numero di immagini che l'elenco di immagini contiene inizialmente.

cGrow

Tipo: int

Numero di immagini in base al quale l'elenco di immagini può aumentare quando il sistema deve fare spazio alle nuove immagini. Questo parametro rappresenta il numero di nuove immagini che l'elenco di immagini ridimensionate può contenere.

Valore restituito

Tipo: HIMAGELIST

Restituisce l'handle all'elenco di immagini in caso di esito positivo o NULL in caso contrario.

Commenti

Al termine dell'uso dell'elenco di immagini, eliminarlo chiamando la funzione ImageList_Destroy .

Nota Comctl32.dll versione 6 non è ridistribuibile, ma è incluso in Windows o versioni successive. Per usare Comctl32.dll versione 6, specificarlo in un manifesto. Per altre informazioni sui manifesti, vedere Abilitazione degli stili di visualizzazione.

 

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h
Libreria	Comctl32.lib
DLL	Comctl32.dll
Set di API	ext-ms-win-shell-comctl32-init-l1-1-1 (introdotto in Windows 10 versione 10.0.14393)