função ImageList_LoadImageA (commctrl.h)

  • Artigo

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 poderá 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 hi 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 hi .

Se hi 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.

ObserveImageList_LoadImage é para uso somente com arquivos bitmap. Não há suporte para nenhum outro tipo 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 seguintes valores.

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 altura especificada pelos valores de métrica do sistema para cursores e ícones se o parâmetro cx estiver definido como zero. Se esse valor não for especificado e cx for definido como zero, a função definirá o tamanho como aquele 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 de 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
 Compartilha o identificador da imagem se a imagem for carregada várias vezes. Não use esse valor para imagens que tenham tamanhos não tradicionais que possam ser alterados após o carregamento ou para imagens carregadas de um arquivo.

Valor retornado

Tipo: HIMAGELIST

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

Comentários

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 uma tela 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 usam 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.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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

Confira também

Loadimage