Compartilhar via


CImageList::Create

Inicializa uma lista de imagem e anexá-la a um objeto de Classe CImageList .

BOOL Create( 
   int cx, 
   int cy, 
   UINT nFlags, 
   int nInitial, 
   int nGrow  
); 
BOOL Create( 
   UINT nBitmapID, 
   int cx, 
   int nGrow, 
   COLORREF crMask  
); 
BOOL Create( 
   LPCTSTR lpszBitmapID, 
   int cx, 
   int nGrow, 
   COLORREF crMask  
); 
BOOL Create( 
   CImageList& imagelist1, 
   int nImage1, 
   CImageList& imagelist2, 
   int nImage2, 
   int dx, 
   int dy  
); 
BOOL Create( 
   CImageList* pImageList  
);

Parâmetros

  • cx
    Dimensões de cada imagem, em pixels.

  • cy
    Dimensões de cada imagem, em pixels.

  • nFlags
    Especifica o tipo da lista de imagem para criar. Este parâmetro pode ser uma combinação dos seguintes valores, mas pode incluir apenas um dos valores de ILC_COLOR .

    Valor

    Significado

    ILC_COLOR

    Use o comportamento padrão se nenhum dos outros ILC_COLOR* os sinalizadores são especificados. Normalmente, o padrão é ILC_COLOR4; mas para um drivers mais antigos de exibição, o padrão é ILC_COLORDDB.

    ILC_COLOR4

    Use um 4 bits (16) cor a seção independente de (DIB) do bitmap como o bitmap para a lista de imagem.

    ILC_COLOR8

    Use uma seção de 8 bits de DIB. As cores usadas para a tabela de cores são as mesmas cores que a paleta de intervalo mínimo.

    ILC_COLOR16

    Use uma seção DIB (cor 32/64k) de 16 bits.

    ILC_COLOR24

    Use um 24 seções de DIB de bit.

    ILC_COLOR32

    Use uma seção de 32 bits de DIB.

    ILC_COLORDDB

    Use um bitmap de dependente de dispositivo.

    ILC_MASK

    Usa uma máscara. A lista de imagem contém dois bitmaps, uma de elas é um bitmap monocromático usado como uma máscara. Se esse valor não é incluído, a lista de imagem contém apenas um bitmap. Consulte Desenhando imagens a partir de uma lista de imagens para obter informações adicionais sobre imagens mascaradas.

  • nInitial
    Número de imagens que a lista de imagem contém inicialmente.

  • nGrow
    Número de imagens pelo qual a lista de imagem pode crescer quando o sistema precisa redimensionar a lista para fazer espaço para novos imagens. Este parâmetro representa o número de novos imagens que a lista redimensionada de imagem pode conter.

  • nBitmapID
    IDs de recurso de bitmap a ser associado com a lista de imagem.

  • crMask
    Cor usada para gerar uma máscara. Cada pixel da cor no bitmap especificado é alterado para enegrecer, e o bit correspondente na máscara é definido como uma.

  • lpszBitmapID
    Uma cadeia de caracteres que contém as identificações de recursos de imagens.

  • imagelist1
    Uma referência a um objeto de CImageList .

  • nImage1
    Índice da primeira imagem existente.

  • imagelist2
    Uma referência a um objeto de CImageList .

  • nImage2
    Índice da segunda imagem existente.

  • dx
    Deslocamento do eixo x da segunda imagem em relação à primeira imagem, em pixels.

  • dy
    Deslocamento do eixo y da segunda imagem em relação à primeira imagem, em pixels.

  • pImageList
    Um ponteiro para um objeto de CImageList .

Valor de retorno

Diferente de zero se com êxito; se não 0.

Comentários

Você constrói CImageList em duas etapas. Primeiro, o construtor e então chame Create, que cria a lista de imagem e a anexar para o objetode CImageList.

Exemplo

m_myImageList.Create(32, 32, ILC_COLOR8, 0, 4);

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe CImageList

Gráfico da hierarquia

CImageList::CImageList

COLORREF

Desenhando imagens a partir de uma lista de imagens