Adicionando colunas ao controle (exibição de relatório)

Observação

O procedimento a seguir se aplica a um objeto CListView ou CListCtrl.

Quando um controle de lista está no modo de exibição de relatório, as colunas são exibidas, fornecendo um método de organização dos vários subitens de cada item de controle de lista. Essa organização é implementada com uma correspondência um para um entre uma coluna no controle de lista e o subitem associado do item de controle de lista. Para obter mais informações sobre subitens, consulte Adicionar itens ao controle. Um exemplo de um controle de lista no modo de exibição de relatório é fornecido pela exibição Detalhes no Windows Explorer do Windows 95 e do Windows 98. A primeira coluna lista pasta, ícones de arquivo e rótulos. Outras colunas listam o tamanho do arquivo, o tipo de arquivo, a data da última modificação e assim por diante.

Embora as colunas possam ser adicionadas a um controle de lista a qualquer momento, elas ficam visíveis somente quando o controle tem o bit de estilo LVS_REPORT ativado.

Cada coluna tem um objeto de cabeçalho associado (consulte CHeaderCtrl) que rotula a coluna e permite que os usuários redimensionem a coluna.

Se o controle de lista der suporte a uma exibição de relatório, você precisará adicionar uma coluna para cada subitem possível em um item de controle de lista. Adicione uma coluna preparando uma estrutura LVCOLUMN e, em seguida, fazendo uma chamada para InsertColumn. Depois de adicionar as colunas necessárias (às vezes denominadas itens de cabeçalho), você pode reordená-las usando funções membro e estilos pertencentes ao controle de cabeçalho inserido. Para obter mais informações, consulte Ordenar itens no controle de cabeçalho.

Observação

Se o controle de lista for criado com o estilo LVS_NOCOLUMNHEADER, qualquer tentativa de inserir colunas será ignorada.

Confira também

Usando CListCtrl
Controles