Compartilhar via


Função ImageList_Create (commctrl.h)

Cria uma nova lista de imagens.

Sintaxe

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

Parâmetros

cx

Tipo: int

A largura, em pixels, de cada imagem.

cy

Tipo: int

A altura, em pixels, de cada imagem.

flags

Tipo: UINT

Um conjunto de sinalizadores de bits que especificam o tipo de lista de imagens a ser criada. Esse parâmetro pode ser uma combinação dos Sinalizadores de Criação de Lista de Imagens.

cInitial

Tipo: int

O número de imagens que a lista de imagens contém inicialmente.

cGrow

Tipo: int

O número de imagens pelas quais a lista de imagens pode crescer quando o sistema precisa abrir espaço para novas imagens. Esse parâmetro representa o número de novas imagens que a lista de imagens redimensionadas pode conter.

Valor retornado

Tipo: HIMAGELIST

Retorna o identificador para a lista de imagens se tiver êxito ou NULL caso contrário.

Comentários

Quando terminar de usar a lista de imagens, destrua-a chamando a função ImageList_Destroy .

Observe Comctl32.dll versão 6 não é redistribuível, mas está incluída no Windows ou posterior. Para usar Comctl32.dll versão 6, especifique-a em um manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.
 

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho commctrl.h
Biblioteca Comctl32.lib
DLL Comctl32.dll
Conjunto de APIs ext-ms-win-shell-comctl32-init-l1-1-1 (introduzido no Windows 10, versão 10.0.14393)