Compartilhar via

ImageList_LoadBitmap macro (commctrl.h)

  • Artigo

Chama a função ImageList_LoadImage para criar uma lista de imagens do recurso de bitmap especificado.

Sintaxe

HIMAGELIST ImageList_LoadBitmap(
   HINSTANCE hi,
   LPCTSTR   lpbmp,
   int       cx,
   int       cGrow,
   COLORREF  crMask
);

Parâmetros

hi

Tipo: HINSTANCE

Um identificador para a instância que contém o recurso de bitmap. Esse parâmetro será NULL se você estiver carregando um bitmap OEM.

lpbmp

Tipo: LPCTSTR

A imagem a ser carregada. Se o parâmetro hi não forNULL, 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 oi for NULL, o LOWORD desse parâmetro deverá ser o identificador de um bitmap OEM a ser carregado. Para criar esse valor, use a macro MAKEINTRESOURCE com um dos identificadores de bitmap OEM definidos em WINUSER.H. Esses identificadores têm o prefixo OBM_.

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 bitmap 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 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.

Valor de retorno

Tipo: HIMAGELIST

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

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