Estilos de List-View estendidos

Artigo
06/13/2023

Use a mensagem LVM_SETEXTENDEDLISTVIEWSTYLE ou uma das macros ListView_SetExtendedListViewStyle ou ListView_SetExtendedListViewStyleEx para empregar esses estilos de controle de exibição de lista estendidos.

Constante	Descrição
LVS_EX_AUTOAUTOARRANGE	Windows Vista e posterior. Organizar ícones automaticamente se nenhuma posição de ícone tiver sido definida (semelhante a LVS_AUTOARRANGE).
LVS_EX_AUTOCHECKSELECT	Windows Vista e posterior. Selecione automaticamente marcar caixas com um único clique.
LVS_EX_AUTOSIZECOLUMNS	Windows Vista e posterior. Dimensione automaticamente as colunas de listview.
LVS_EX_BORDERSELECT	Versão 4.71 e posterior. Altera a cor da borda quando um item é selecionado, em vez de realçar o item.
LVS_EX_CHECKBOXES	Versão 4.70. Habilita marcar caixas para itens em um controle de exibição de lista. Quando definido como esse estilo, o controle cria e define uma lista de imagens de estado com duas imagens usando DrawFrameControl. A imagem de estado 1 é a caixa desmarcada e a imagem de estado 2 é a caixa de seleção. Definir a imagem de estado como zero remove a caixa marcar. Versão 6.00 e posterior As caixas de seleção são visíveis e funcionais com todos os modos de exibição de lista, exceto o modo de exibição de bloco introduzido no ComCtl32.dll versão 6. Clicar em uma caixa de seleção no modo de exibição de bloco seleciona apenas o item; o estado não é alterado. Você pode obter o estado da caixa marcar para um determinado item com ListView_GetCheckState. Para definir o estado marcar, use ListView_SetCheckState. Se esse estilo for definido, o controle de exibição de lista alterna automaticamente o estado marcar quando o usuário clica na caixa marcar ou pressiona a barra de espaço.
LVS_EX_COLUMNOVERFLOW	Indica que um botão de estouro deve ser exibido no modo de exibição de ícone/bloco se não houver largura de cliente suficiente para exibir o conjunto completo de itens de cabeçalho. O controle de exibição de lista envia a notificação de LVN_COLUMNOVERFLOWCLICK quando o botão de estouro é clicado. Esse sinalizador só é válido quando LVS_EX_HEADERINALLVIEWS também é especificado.
LVS_EX_COLUMNSNAPPOINTS	Windows Vista e posterior. Ajustar à largura mínima da coluna quando o usuário redimensionar uma coluna.
LVS_EX_DOUBLEBUFFER	Versão 6.00 e posterior. Pinta por meio de buffer duplo, o que reduz a cintilação. Esse estilo estendido também permite a seleção de letreiro com mistura alfa em sistemas em que há suporte.
LVS_EX_FLATSB	Habilita barras de rolagem simples no modo de exibição de lista. Se você precisar de mais controle sobre a aparência das barras de rolagem do modo de exibição de lista, deverá manipular as barras de rolagem do modo de exibição de lista diretamente usando as APIs da Barra de Rolagem Simples. Se as métricas do sistema forem alteradas, você será responsável por ajustar as métricas da barra de rolagem com FlatSB_SetScrollProp. Consulte Barras de Rolagem Simples para obter mais detalhes.
LVS_EX_FULLROWSELECT	Quando um item é selecionado, o item e todos os subitens são realçados. Esse estilo só está disponível em conjunto com o estilo LVS_REPORT .
LVS_EX_GRIDLINES	Exibe linhas de grade em torno de itens e subitems. Esse estilo só está disponível em conjunto com o estilo LVS_REPORT .
LVS_EX_HEADERDRAGDROP	Habilita a reordenação do tipo "arrastar e soltar" de colunas em um controle de exibição de lista. Esse estilo só está disponível para controles de exibição de lista que usam o estilo LVS_REPORT .
LVS_EX_HEADERINALLVIEWS	Windows Vista e posterior. Mostrar cabeçalhos de coluna em todos os modos de exibição.
LVS_EX_HIDELABELS	Versão 6.00 e posterior. Oculta os rótulos no ícone e no modo de exibição de ícone pequeno.
LVS_EX_INFOTIP	Quando um controle de exibição de lista usa o estilo LVS_EX_INFOTIP , o código de notificação LVN_GETINFOTIP é enviado para a janela pai antes de exibir a dica de ferramenta de um item.
LVS_EX_JUSTIFYCOLUMNS	Windows Vista e posterior. Os ícones são alinhados em colunas que usam o modo de exibição inteiro.
LVS_EX_LABELTIP	Se um rótulo parcialmente oculto em qualquer modo de exibição de lista não tiver texto de dica de ferramenta, o controle de exibição de lista desdobrará o rótulo. Se esse estilo não estiver definido, o controle de exibição de lista desdobrará rótulos parcialmente ocultos apenas para o modo de ícone grande.
LVS_EX_MULTIWORKAREAS	Se o controle de exibição de lista tiver o estilo LVS_AUTOARRANGE , o controle não reorganizará automaticamente seus ícones até que uma ou mais áreas de trabalho sejam definidas (consulte LVM_SETWORKAREAS). Para ser eficaz, esse estilo deve ser definido antes que qualquer área de trabalho seja definida e todos os itens tenham sido adicionados ao controle.
LVS_EX_ONECLICKACTIVATE	O controle de exibição de lista envia um código de notificação LVN_ITEMACTIVATE para a janela pai quando o usuário clica em um item. Esse estilo também habilita o acompanhamento frequente no controle de exibição de lista. O acompanhamento frequente significa que, quando o cursor se move sobre um item, ele é realçado, mas não selecionado. Consulte a seção Comentários de estilos de List-View estendidos para obter uma discussão sobre ativação de item.
LVS_EX_REGIONAL	Somente versão 4.71 até a versão 5.80. Sem suporte no Windows Vista e posterior. Define a região da janela de exibição de lista para incluir apenas os ícones de item e o texto usando SetWindowRgn. Qualquer área que não faça parte de um item é excluída da região da janela. Esse estilo só está disponível para controles de exibição de lista que usam o estilo LVS_ICON .
LVS_EX_SIMPLESELECT	Versão 6.00 e posterior. No modo de exibição de ícone, move a imagem de estado do controle para o canto superior direito da renderização de ícone grande. Em modos de exibição diferentes do modo de exibição de ícone, não há nenhuma alteração. Quando o usuário altera o estado usando a barra de espaço, todos os itens selecionados circulam, não o item com o foco.
LVS_EX_SINGLEROW	Versão 6.00 e posterior. Não usado.
LVS_EX_SNAPTOGRID	Versão 6.00 e posterior. No modo de exibição de ícone, os ícones são ajustados automaticamente em uma grade.
LVS_EX_SUBITEMIMAGES	Permite que as imagens sejam exibidas para subitems. Esse estilo só está disponível em conjunto com o estilo LVS_REPORT .
LVS_EX_TRACKSELECT	Habilita a seleção de faixa dinâmica em um controle de exibição de lista. A seleção de faixa dinâmica significa que um item é selecionado automaticamente quando o cursor permanece sobre o item por um determinado período de tempo. O atraso pode ser alterado da configuração padrão do sistema com uma mensagem de LVM_SETHOVERTIME . Esse estilo se aplica a todos os estilos de controle de exibição de lista. Você pode marcar se a seleção de hot-track está habilitada chamando SystemParametersInfo.
LVS_EX_TRANSPARENTBKGND	Windows Vista e posteriores. A tela de fundo é pintada pelo pai por meio de WM_PRINTCLIENT.
LVS_EX_TRANSPARENTSHADOWTEXT	Windows Vista e posteriores. Habilite o texto de sombra apenas em telas de fundo transparentes.
LVS_EX_TWOCLICKACTIVATE	O controle list-view envia um código de notificação LVN_ITEMACTIVATE para a janela pai quando o usuário clica duas vezes em um item. Esse estilo também habilita o acompanhamento frequente no controle de exibição de lista. O acompanhamento frequente significa que, quando o cursor se move sobre um item, ele é realçado, mas não selecionado. Consulte a seção Comentários de estilos de List-View estendidos para obter uma discussão sobre a ativação do item.
LVS_EX_UNDERLINECOLD	Faz com que esses itens não quentes que podem ser ativados sejam exibidos com texto sublinhado. Esse estilo exige que LVS_EX_TWOCLICKACTIVATE também sejam definidos. Consulte a seção Comentários de estilos de List-View estendidos para obter uma discussão sobre a ativação do item.
LVS_EX_UNDERLINEHOT	Faz com que esses itens quentes que podem ser ativados sejam exibidos com texto sublinhado. Esse estilo exige que LVS_EX_ONECLICKACTIVATE ou LVS_EX_TWOCLICKACTIVATE também sejam definidos. Consulte a seção Comentários de estilos de List-View estendidos para obter uma discussão sobre a ativação do item.

Comentários

Observação

Comctl32.dll versão 6 não é redistribuível, mas está incluída no Windows. Para usar Comctl32.dll versão 6, especifique-a em um manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

Um item fica quente quando o mouse passa o mouse sobre ele. Se o controle frequente estiver habilitado, os itens quentes serão realçados, mas o usuário ainda deverá clicar no item pelo menos uma vez para selecioná-lo. Ativar um item faz com que o controle de exibição de lista envie uma notificação de LVN_ITEMACTIVATE . Um item pode ser selecionado quando estiver em um estado no qual um único clique o selecionará.

Se o estilo LVS_EX_ONECLICKACTIVATE estiver definido, apenas um clique será necessário para selecionar qualquer item, portanto, todos os itens poderão ser selecionados. Se o estilo LVS_EX_TWOCLICKACTIVATE estiver definido, serão necessários dois cliques para selecionar um item. Com esse estilo, o item pode ser selecionado somente depois de ter sido clicado uma vez.

Definir o estilo LVS_EX_UNDERLINEHOT fará com que o texto de qualquer item quente que possa ser selecionado seja sublinhado. Definir o estilo LVS_EX_UNDERLINECOLD fará com que o texto de itens que não estão quentes, mas que podem ser selecionados, seja sublinhado.

Requisitos

Requisito	Valor
parâmetro	CommCtrl.h

Confira também