Compartilhar via


ImageList_ExtractIcon macro (commctrl.h)

Chama a função ImageList_GetIcon para criar um ícone ou cursor com base em uma imagem e máscara em uma lista de imagens.

Sintaxe

HICON ImageList_ExtractIcon(
   HINSTANCE  hi,
   HIMAGELIST himl,
   int        i
);

Parâmetros

hi

Tipo: HINSTANCE

Esse parâmetro não é usado e deve ser sempre zero.

himl

Tipo: HIMAGELIST

Um identificador para a lista de imagens.

i

Tipo: int

O índice da imagem.

Valor de retorno

Tipo: HICON

Retorna o identificador do ícone ou cursor se bem-sucedido ou NULL caso contrário.

Observações

É responsabilidade do aplicativo de chamada destruir o ícone retornado dessa função usando a função DestroyIcon.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho commctrl.h