Compartilhar via

Como usar grupos em uma exibição de lista

  • Artigo

Este tópico descreve como criar uma instância de um grupo e adicioná-la a um controle de exibição de lista. O agrupamento permite que um usuário organize listas em grupos de itens que são divididos visualmente na página, usando um divisor horizontal e um título de grupo.

O que você precisa saber

Tecnologias

Pré-requisitos

  • C/C++
  • Programação da interface do usuário do Windows

Instruções

Para usar grupos em um controle de exibição de lista, verifique se o controle inclui o estilo de janela LVS_ALIGNTOP.

Ao adicionar um item à lista, você o atribui a um grupo definindo o membro iGroupId da estrutura LVITEM do item como o valor do membro iGroupId da estrutura LVGROUP dos grupos. Um item que não é atribuído a um grupo não aparece na lista quando o modo de exibição de grupo está habilitado. Para habilitar ou desabilitar o modo de exibição de grupo, use a macro ListView_EnableGroupView.

O exemplo a seguir mostra como criar um grupo com um cabeçalho e adicioná-lo a um controle de exibição de lista.

    LVGROUP group;

    group.cbSize    = sizeof(LVGROUP);
    group.mask      = LVGF_HEADER | LVGF_GROUPID;
    group.pszHeader = TEXT("Dogs");
    group.iGroupId  = 1;

    ListView_InsertGroup(hWndListView, -1, &group);

Referência de controle List-View

Sobre controles de exibição de lista

Usando controles de exibição de lista