função ImageList_LoadImageA (commctrl.h)

Cria uma lista de imagens do bitmap especificado.

Sintaxe

HIMAGELIST ImageList_LoadImageA(
  HINSTANCE hi,
  LPCSTR    lpbmp,
  int       cx,
  int       cGrow,
  COLORREF  crMask,
  UINT      uType,
  UINT      uFlags
);

Parâmetros

hi

Tipo: HINSTANCE

Um identificador para a instância que contém o recurso. Esse parâmetro pode ser NULL se você estiver carregando uma imagem de um arquivo ou carregando um recurso OEM.

lpbmp

Tipo: LPCTSTR

A imagem a ser carregada.

Se o parâmetro uFlags incluir LR_LOADFROMFILE, lpbmp será o endereço de uma cadeia de caracteres terminada em nulo que nomeia o arquivo que contém a imagem a ser carregada.

Se o parâmetro oi não for NULL e LR_LOADFROMFILE não for especificado, lpbmp será o endereço de uma cadeia de caracteres terminada em nulo que contém o nome do recurso de imagem no módulo de hi .

Se oi for NULL e LR_LOADFROMFILE não for especificado, o LOWORD desse parâmetro deverá ser o identificador de uma imagem OEM a ser carregada. Para criar esse valor, use a macro MAKEINTRESOURCE com um dos identificadores de imagem OEM definidos em Winuser.h. Esses identificadores têm os seguintes prefixos.

Valor	Significado
OBM_ para bitmaps OEM
OIC_ para ícones OEM
OCR_ para cursores OEM

cx

Tipo: int

A largura de cada imagem. A altura de cada imagem e o número inicial de imagens são inferidos pelas dimensões do recurso especificado.

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.

crMask

Tipo: COLORREF

A cor usada para gerar uma máscara. Cada pixel dessa cor no bitmap, cursor ou ícone especificado é alterado para preto e o bit correspondente na máscara é definido como 1. Se esse parâmetro for o valor CLR_NONE, nenhuma máscara será gerada. Se esse parâmetro for o valor CLR_DEFAULT, a cor do pixel no canto superior esquerdo da imagem será tratada como a cor da máscara.

uType

Tipo: UINT

Um sinalizador que especifica o tipo de imagem a ser carregada. Esse parâmetro deve ser IMAGE_BITMAP para indicar que um bitmap está sendo carregado.

ObservaçãoImageList_LoadImage é para uso somente com arquivos bitmap. Não há suporte para outros tipos de imagem.

 

Valor	Significado
IMAGE_BITMAP	Carrega um bitmap.

uFlags

Tipo: UINT

Sinalizadores que especificam como carregar a imagem. Esse parâmetro pode ser uma combinação dos valores a seguir.

Valor	Significado
LR_CREATEDIBSECTION	Faz com que a função retorne um bitmap de seção DIB em vez de um bitmap compatível quando o parâmetro uType especifica IMAGE_BITMAP. LR_CREATEDIBSECTION é útil para carregar um bitmap sem mapeá-lo para as cores do dispositivo de exibição.
LR_DEFAULTCOLOR	Usa o formato de cor da exibição.
LR_DEFAULTSIZE	Usará a largura ou a altura especificada pelos valores de métrica do sistema para cursores e ícones se o parâmetro cx for definido como zero. Se esse valor não for especificado e cx for definido como zero, a função definirá o tamanho como o especificado no recurso. Se o recurso contiver várias imagens, a função definirá o tamanho como o da primeira imagem.
LR_LOADFROMFILE	Carrega a imagem do arquivo especificado pelo parâmetro lpbmp.
LR_LOADMAP3DCOLORS	Pesquisa a tabela de cores da imagem e substitui os seguintes tons de cinza pela cor tridimensional correspondente: Dk Gray: RGB(128, 128, 128)COLOR_3DSHADOW Cinza: RGB(192, 192, 192)COLOR_3DFACE Lt Gray: RGB(223, 223, 223)COLOR_3DLIGHT Para obter mais informações, consulte a seção Comentários.
LR_LOADTRANSPARENT	Recupera o valor de cor do primeiro pixel na imagem e substitui a entrada correspondente na tabela de cores pela cor da janela padrão (a cor de exibição COLOR_WINDOW). Todos os pixels na imagem que usam essa cor se tornam a cor de valor da janela padrão. Esse valor se aplica somente a imagens que têm uma tabela de cores correspondente. Para obter mais informações, consulte a seção Comentários.
LR_MONOCHROME	Carrega a imagem em preto e branco.
LR_SHARED	Compartilhará o identificador de imagem se a imagem for carregada várias vezes. Não use esse valor para imagens que têm tamanhos não tradicionais que podem ser alterados após o carregamento ou para imagens carregadas de um arquivo.

Valor de retorno

Tipo: HIMAGELIST

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

Observações

LR_LOADTRANSPARENT não carrega a imagem de forma transparente. Ele cria uma lista de imagens opacas que só aparece transparente porque todos os pixels de plano de fundo foram alterados para COLOR_WINDOW. Se as imagens forem desenhadas em um plano de fundo que não seja a cor COLOR_WINDOW, a imagem não será desenhada corretamente. Além disso, LR_LOADTRANSPARENT e LR_LOADMAP3DCOLORS usar as cores do sistema que estavam em vigor no momento em que ImageList_LoadImage foi chamado. Se as cores do sistema forem alteradas posteriormente, o aplicativo deverá recarregar a imagem para remapear as cores.

Nota

O cabeçalho commctrl.h define ImageList_LoadImage como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

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
biblioteca	Comctl32.lib
de DLL	Comctl32.dll

Consulte também

LoadImage