Como usar exibições de bloco
Este tópico demonstra como definir o modo de exibição de bloco para um controle de exibição de lista. No modo de exibição de bloco, cada item é representado por um ícone grande com uma ou mais linhas de texto que o acompanham. Para obter uma ilustração, consulte Sobre controles de exibição de lista.
O que você precisa saber
Tecnologias
Pré-requisitos
- C/C++
- Programação da interface do usuário do Windows
Instruções
Defina os parâmetros gerais de exibição para o modo de exibição de bloco usando a macro ListView_SetTileViewInfo. Use a estrutura LVTILEVIEWINFO que é passada para essa macro para especificar a posição do texto em relação ao ícone, o tamanho de cada bloco (incluindo o texto que o acompanha) e o número máximo de linhas de texto.
Se você não quiser que os blocos sejam dimensionados automaticamente, defina LVTVIF_FIXEDSIZE no membro dwFlags e LVTVIM_TILESIZE no membro dwMask do LVTILEVIEWINFO, além de fornecer as dimensões no membro sizeTile.
O exemplo de código C++ a seguir define as informações de exibição de bloco para um controle de exibição de lista para que um máximo de dois subitens sejam exibidos para cada item. Ele também define o tamanho de cada bloco.
SIZE size = { 100, 50 };
LVTILEVIEWINFO tileViewInfo = {0};
tileViewInfo.cbSize = sizeof(tileViewInfo);
tileViewInfo.dwFlags = LVTVIF_FIXEDSIZE;
tileViewInfo.dwMask = LVTVIM_COLUMNS | LVTVIM_TILESIZE;
tileViewInfo.cLines = 2;
tileViewInfo.sizeTile = size;
ListView_SetTileViewInfo(hWndListView, &tileViewInfo);
Para cada item na lista, você pode definir parâmetros adicionais quando o item for inserido na lista ou posteriormente. A estrutura LVITEM usada com ListView_InsertItem contém membros que especificam quais colunas de dados serão exibidas abaixo do item e seu alinhamento. Esses mesmos parâmetros de exibição também são encontrados na estrutura LVTILEINFO usada com ListView_SetTileInfo.
Observação
"Colunas" aqui não se refere a exibir colunas no modo de exibição de bloco, mas sim a subitens, que são exibidos em colunas no modo de exibição de detalhes.
Tópicos relacionados