Classe CListCtrl
Encapsula a funcionalidade de um "controle de modo de exibição de lista," que exibe uma coleção de itens de cada uma consistindo em um ícone (a partir de uma lista de imagens) e um rótulo.
class CListCtrl : public CWnd
Comentários
Um ícone além do rótulo, cada item pode ter informações exibidas em colunas à direita do ícone e etiqueta.Esse controle (e, portanto, a CListCtrl classe) está disponível somente para programas em execução no Windows 95/98 e Windows NT versão 3.51 e posterior.
Este é uma visão geral o CListCtrl classe. Para obter mais informações detalhadas, conceituais, consulte Usando CListCtrl and Controles.
Modos de exibição
Controles de exibição de lista podem exibir seu Sumário de quatro maneiras diferentes, chamadas "modos de exibição".
ícone modo de exibição
Cada item aparece sistema autônomo um ícone em tamanho normal (32 x 32 pixels) com um rótulo abaixo dela.O usuário pode arrastar os itens em qualquer local na janela de exibição lista.
Modo de exibição de ícones pequenos
Cada item aparece sistema autônomo um ícone pequeno (16 x 16 pixels) com o rótulo à direita dele.O usuário pode arrastar os itens em qualquer local na janela de exibição lista.
Modo de exibição de lista
Cada item é exibido sistema autônomo um pequeno ícone com um rótulo à direita dela.Itens são organizados em colunas e não podem ser arrastados para qualquer local na janela de exibição da lista.
Modo de exibição de relatório
Cada item é exibido em sua própria linha, com informações adicionais, organizadas em colunas à direita.A coluna mais à esquerda contém o ícone pequeno e o rótulo e colunas subseqüentes contêm subitens conforme especificado pelo aplicativo.Um controle de cabeçalho incorporado (classe CHeaderCtrl) implementa essas colunas.Para obter mais informações no controle de cabeçalho e colunas em um modo de exibição de relatório, consulte Usando CListCtrl: Adicionando colunas para o controle (modo de exibição de relatório).
Consulte também:
Artigo da Base de dados de Conhecimento Q250614: HOWTO: Classificar itens em um CListCtrl no modo de exibição de relatório
Artigo da Base de dados de Conhecimento Q200054: PRB: OnTimer() não é chamado repetidamente para um controle de lista
O estilo de exibição de lista corrente do controle determina o modo de exibição corrente.Para obter mais informações sobre esses estilos e seu uso, consulte Usando CListCtrl: Alterando estilos de controle de lista.
Estilos estendidos
Juntamente com os estilos de lista padrão de classe CListCtrl oferece suporte a um grande conjunto de estilos estendidos, fornecendo funcionalidade rico. Estes são alguns exemplos dessa funcionalidade:
Posicionar seleção
Quando ativada, permite a seleção automático de um item quando o cursor permanece sobre o item para um determinado período de time.
Modos de exibição de lista virtual
Quando ativada, permite que o controle dar suporte a até DWORD itens. Isso é possível, colocando a sobrecarga de gerenciamento de dados do item no aplicativo.Exceto para a seleção do item e informações de foco, todas as informações de item devem ser gerenciadas pelo aplicativo.Para obter mais informações, consulte Usando CListCtrl: De controles de lista virtual.
One– e two– clicar ativação
Quando habilitado, permite hot (realce automático de texto do item) de acompanhamento e one– ou two– em ativação do item realçado.
arrastar e solte a ordenação de colunas
Quando habilitado, permite do tipo arrastar e soltar reordenação de colunas em um controle de exibição de lista.Disponível somente no modo de exibição de relatório.
Para obter informações sobre o uso desses novos estilos estendidos, consulte Usando CListCtrl: Alterando estilos de controle de lista.
Itens e subitens
Cada item em um controle de exibição de lista consiste em um ícone (a partir de uma lista de imagens), um rótulo, um estado corrente e um valor definido pelo aplicativo (conhecido sistema autônomo "item de dados").Um ou mais subitens também podem ser associados com cada item."subitem" é uma seqüência de caracteres que, no modo de exibição de relatório, pode ser exibida em uma coluna à direita do ícone e o rótulo do item.Todos os itens em um controle de modo de exibição de lista devem ter o mesmo número subitens.
De classeCListCtrl fornece várias funções para inserir, excluir, localizando e modificar esses itens.Para obter mais informações, consulte CListCtrl::GetItem, CListCtrl::InsertItem, and CListCtrl::FindItem, Usando CListCtrl: Adicionando itens ao controlee Usando CListCtrl: Rolagem, organizando, classificando e localizando em controles lista.
Por padrão, o controle de modo de exibição de lista é responsável por armazenar atributos de ícone e texto do item.No entanto, juntamente com esses tipos de item de classe CListCtrloferece suporte a "retorno de chamada de itens." Um "item de retorno de chamada" é um item de modo de exibição de lista para o qual o aplicativo — em vez do controle — armazena o texto, ícone ou ambos.Uma máscara de retorno de chamada é usada para especificar quais atributos do item (texto e/ou ícone) são fornecidos pelo aplicativo.Se um aplicativo usa itens de retorno de chamada, ele deve poderá fornecer os atributos de texto e/ou ícone sob demanda.Itens de retorno de chamada são úteis quando seu aplicativo já mantém algumas dessas informações.Para obter mais informações, consulte Usando CListCtrl: Itens de retorno de chamada e a máscara de retorno de chamada.
Listas de imagem
Os ícones, imagens de item de cabeçalho e estados aplicativo– definido para modo de exibição de lista itens estão contidos em várias listas de imagem (implementadas pela classe CImageList), que você criar e atribuir para o controle de modo de exibição de lista.Cada controle de modo de exibição de lista pode ter até quatro diferentes tipos de listas de imagem:
Ícone grande
Usado no modo de exibição de ícones para ícones em tamanho normal.
Ícone pequeno
Usado no ícone pequeno, lista e modos de exibição de relatório para versões menores dos ícones usados no modo de exibição de ícones.
Estado definido pelo aplicativo
Contém imagens de estado, que são exibidas ao lado do ícone de um item para indicar um estado definido pelo aplicativo.
"Item de cabeçalho"
Usado no modo de exibição de relatório para pequenas imagens que aparecem em cada item de controle de cabeçalho.
Por padrão, um controle de exibição de lista destrói sistema autônomo listas de imagem atribuídas a ele quando destruí-la; no entanto, o desenvolvedor pode personalizar esse comportamento, destruir cada lista de imagem quando não é usada, conforme determinado pelo aplicativo.Para obter mais informações, consulte Usando CListCtrl: Imagem listas e itens de lista.
Requisitos
Cabeçalho: afxcmn.h
Consulte também
Tarefas
Exemplo ROWLIST: Demonstra a selecionar linhas Completo nos modos de exibição de lista