Adicionando itens ao controle

Para adicionar itens ao controle de lista (CListCtrl), chame uma das várias versões da função de membro InsertItem , dependendo das informações que 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 (no que diz respeito à visão do relatório) da estrutura LVITEM são os membros iItem e iSubItem. O iItem membro é o índice baseado em zero do item ao qual a estrutura está se referindo e o iSubItem membro é o índice baseado em um de um subitem, ou zero se a estrutura contiver informações sobre um item. Com esses dois membros, você determina, por item, o tipo e o valor das informações do subitem que são 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, o ícone, o estado e os dados do item. "Dados do 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 do InsertItem usam um ou mais valores separados, correspondentes aos membros na LVITEM estrutura, permitindo que você inicialize apenas os membros aos quais 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 retorno de chamada". Para obter mais informações, consulte Itens de retorno de chamada e a máscara de retorno de chamada neste tópico e Itens de retorno de chamada e a máscara de retorno de chamada no SDK do Windows.

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

Ver também

Usando CListCtrl
Controlos