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 estrutura LVITEM contém vários membros, você tem maior controle sobre os atributos do item de controle de lista.

Dois membros importantes (em relação à 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 que a estrutura está referenciando, e o membro iSubItem é 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 de 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" são um valor definido pelo aplicativo associado a um item de exibição de lista. Para obter mais informações sobre a estrutura LVITEM, confira CListCtrl::GetItem.

Outras versões de InsertItem usam um ou mais valores separados, correspondentes aos membros na estrutura LVITEM, permitindo que você inicialize somente os membros a que deseja dar suporte. Geralmente, o controle de lista gerencia o armazenamento de itens de lista, mas você pode armazenar algumas das informações no 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 itens e subitens de exibição de lista.

Confira também

Usando CListCtrl
Controles