Adicionando itens ao controle

Para adicionar itens ao controle de lista (CListCtrl), chame uma das várias versões da função membro InsertItem , dependendo de quais informações você tem. Uma versão usa uma estrutura LVITEM que você prepara. Como a LVITEM estrutura contém vários membros, você tem maior controle sobre os atributos do item de controle de lista.

Dois membros importantes (em relação ao modo de exibição de relatório) da estrutura LVITEM são os membros iItem e iSubItem. O membro iItem é o índice baseado em zero do item ao qual a estrutura está fazendo referência, e o membro iSubItem é o índice baseado em um do subitem, ou zero se a estrutura contiver informações apenas sobre um item. Com esses dois membros, você determina, por item, o tipo e o valor das informações de subitem exibidas quando o controle de lista está no modo de exibição de relatório. Para obter mais informações, consulte CListCtrl::SetItem.

Membros adicionais especificam o texto, ícone, estado e dados do item. "Dados de item" é um valor definido pelo aplicativo associado a um item de exibição de lista. Para obter mais informações sobre a LVITEM estrutura, consulte CListCtrl::GetItem.

Outras versões de InsertItem aceitam um ou mais valores separados, correspondentes aos membros na estrutura do LVITEM, permitindo inicializar apenas os membros que você deseja dar suporte. Geralmente, o controle de lista gerencia o armazenamento para itens de lista, mas você pode armazenar algumas das informações em seu aplicativo usando "itens de callback". Para obter mais informações, consulte Itens de Callback e a Máscara de Retorno de Chamada neste tópico e Itens de Callback e a Máscara de Retorno de Chamada no SDK do Windows.

Para obter mais informações, consulte Adicionando itens List-View e subitens.

Consulte também

Usando CListCtrl
Controles