Itens de lista e listas de imagens

Um "item" em um controle de lista (CListCtrl) consiste em um ícone, um rótulo e, possivelmente, outras informações (em "subitems").

Os ícones dos itens de controle de lista estão contidos em listas de imagens. Uma lista de imagens contém ícones em tamanho completo usados na exibição de ícone. Uma segunda lista de imagens, opcional, contém versões menores dos mesmos ícones para uso em outras exibições do controle. Uma terceira lista opcional contém imagens de "estado", como caixas de seleção, para exibição na frente dos ícones pequenos em determinadas exibições. Uma quarta lista opcional contém imagens exibidas em itens de cabeçalho individuais do controle de lista.

Observação

Se um controle de exibição de lista for criado com o estilo LVS_SHAREIMAGELISTS, você será responsável por destruir as listas de imagens quando elas não estiverem mais em uso. Especifique esse estilo se você atribuir as mesmas listas de imagens a vários controles de exibição de lista. Caso contrário, mais de um controle poderá tentar destruir a mesma lista de imagens.

Para obter mais informações sobre itens de lista, consulte Listas de imagens da exibição de lista e Itens e subitens no SDK do Windows. Consulte também a classe CImageList na Referência do MFC e Usando CImageList nesta família de artigos.

Para criar um controle de lista, você precisa fornecer listas de imagens a serem usadas ao inserir novos itens na lista. O exemplo a seguir demonstra esse procedimento, em que m_pImagelist é um ponteiro do tipo CImageList e m_listctrl é um membro de dados CListCtrl.

m_ListImageList.Create(16, 16, ILC_COLOR, 2, 2);
m_ListImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON1));
m_ListImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON2));
m_ListCtrl.SetImageList(&m_ListImageList, LVSIL_SMALL);

No entanto, se você não planeja exibir ícones em sua exibição de lista ou controle de lista, não precisa de listas de imagens.

Confira também

Usando CListCtrl
Controles