Compartilhar via


CImageList::Create

Inicializa uma lista de imagem e anexá-la a um objeto de Classe de 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 Desenho de imagens de uma lista de imagem 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 de CImageList

Gráfico de hierarquia

CImageList::CImageList

COLORREF

Desenho de imagens de uma lista de imagem