Classe de CListCtrl

Encapsula funcionalidade de “de um controle exibição de lista”, que exibe uma coleção de itens cada que consiste em um ícone (de uma lista de imagem e) em um rótulo.

class CListCtrl : public CWnd

Membros

Construtores public

Métodos públicos

Comentários

Além do que um ícone e um rótulo, cada item pode ter informações exibidas nas colunas à direita do ícone e do rótulo.Este controle (e portanto a classe de CListCtrl ) estão disponíveis somente para programas que executam na versão 3,51 do /98 Windows 95 e Windows NT e posterior.

A seguir está uma breve visão geral da classe de CListCtrl .Para uma discussão detalhada, conceitualmente, consulte usando CListCtrl e Controles.

Modos de exibição

Controles de exibição de lista podem exibir seu conteúdo em quatro maneiras diferentes, chamadas “visualizações.”

• Modo de exibição de ícones

  Cada item aparece como um pixels sem tamanho máximo de ícone (32 x 32) com um rótulo abaixo de ele.O usuário pode arrastar itens em qualquer local na janela de exibição de lista.

• Pequena exibição de ícones

  Cada item aparece como um pixels pequenos ícone (16 x 16) com o rótulo à direita de ele.O usuário pode arrastar itens em qualquer local na janela de exibição de lista.

• Exibição da lista

  Cada item aparece como um ícone pequeno com um rótulo à direita de ele.Os itens são organizados em colunas e não podem ser arrastados a qualquer lugar na janela de exibição de lista.

• Visualização de relatório

  Cada item aparecerá em sua própria linha, com informações adicionais organizada em colunas à direita.A coluna mais à esquerda contém o ícone e o rótulo pequenos, e colunas subseqüentes contém sub-itens como especificados pelo aplicativo.Um controle de cabeçalho inserido (classe) CHeaderCtrlimplementa essas colunas.Para obter mais informações sobre o controle e colunas de cabeçalho em um visualizador de relatório, consulte usando CListCtrl: adicionando colunas ao controle (visualização de relatório).

Consulte também:

• Artigo de Base de Dados de Conhecimento Q250614: HOWTO: Itens de tipo em um CListCtrl no visualizador de relatório

• Artigo de Base de Dados de Conhecimento Q200054: PRB: OnTimer () não é chamada repetidamente para um controle de lista

O estilo de exibição de lista atual do controle determina o modo de exibição atual.Para obter mais informações sobre esses estilos e seu uso, consulte usando CListCtrl: Alterando estilos de controle list.

Estilos estendidos

Além dos estilos padrão da lista, a classe CListCtrl oferece suporte a um grande conjunto de estilos estendidos, fornecendo a funcionalidade enriquecida.Alguns exemplos de essa funcionalidade incluem:

• Passagem do mouse via seleção

  Quando ativado, automático permite a seleção de um item quando o cursor permanece sobre o item por um determinado período de tempo.

• Modos de exibição de lista virtuais

  Quando ativado, permite que o controle dê suporte até DWORD itens.Isso é possível colocar a sobrecarga de gerenciamento dados do item no aplicativo.A exceção de seleção de item e informações de foco, todas as informações de item deve ser gerenciada pelo aplicativo.Para obter mais informações, consulte usando CListCtrl: Controles de lista virtuais.

• Ativação de um e dois cliques

  Quando ativado, permite o rastreamento quente (realce automática de texto do item) e a ativação de um ou dois cliques de item realçado.

• Ordenação de coluna de arrastar e soltar

  Quando ativado, permite reordenar de arrastar e soltar de colunas em um controle de exibição de lista.Disponível somente no visualizador de relatório.

Para obter informações sobre como usar esses novos estilos estendidos, consulte usando CListCtrl: Alterando estilos de controle list.

Itens e sub-itens

Cada item em um controle de exibição de lista consiste em um ícone (de uma lista de imagem), em um rótulo, em um estado atual, e um valor definido (conhecido como “item de dados”).Um ou mais sub-itens também podem ser associados a cada item.” É um “subitens uma cadeia de caracteres que, no visualizador de relatório, pode ser exibida em uma coluna à direita do ícone e do rótulo de um item.Todos os itens em um controle de exibição de lista deve ter o mesmo número de subitens.

A classe CListCtrl fornece várias funções para inserir, excluir, localize, e alterar esses itens.Para obter mais informações, consulte CListCtrl::GetItem, CListCtrl::InsertItem, e CListCtrl::FindItem, usando CListCtrl: Adicionando itens para o controle, e usando CListCtrl: Imprima, organizar, classificar, e localizar nos controles de lista.

Por padrão, o controle de exibição de lista é responsável para armazenar os atributos do ícone e o texto de um item.Em o entanto, além de esses tipos de item, a classe CListCtrl suporta “itens de retorno de chamada”. “Item de um retorno de chamada” é um item de exibição de lista para que o aplicativo — em vez do controle — armazenamentos texto, o ícone, ou ambos.Uma máscara de retorno de chamada é usada para especificar que os atributos de item (texto) e/ou ícone são fornecidos pelo aplicativo.Se um aplicativo usa itens de retorno de chamada, ele deve ser capaz de fornecer os atributos de texto e/ou ícone sob demanda.Os itens de retorno de chamada são úteis quando o aplicativo ainda mantém algumas de essas informações.Para obter mais informações, consulte usando CListCtrl: Itens de retorno de chamada e a máscara de retorno de chamada.

Criar imagem listas

Ícones, imagens de item de cabeçalho, e os estados definidos aplicativo para itens de exibição de lista estão contidos em diversas listas de imagem (implementadas pela classe CImageList), que você crie e atribui ao controle de exibição de lista.Cada controle de list view pode ter até quatro tipos diferentes de listas de imagem:

• Ícone grande

  Usado em modo de exibição de ícones para ícones sem tamanho máximo.

• Ícone pequeno

  Usado no ícone, na lista, e nas visualizações de relatório pequenos para versões menores de ícones usados no modo de ícone.

• Estado definido

  Contém as imagens de estado, que são exibidas ao lado do ícone de um item para indicar um estado definido.

• "Item de cabeçalho"

  Usado no visualizador de relatório para as imagens pequenas que aparecem em cada item de controle header.

Por padrão, um controle de exibição de lista for as listas de imagem atribuídas a quando ele for destruído; no entanto, o desenvolvedor pode personalizar esse comportamento destruindo cada lista de imagem quando não é usado, conforme determinado pelo aplicativo.Para obter mais informações, consulte usando CListCtrl: Itens de lista e listas de imagem.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CListCtrl

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

CWnd Class

Gráfico de hierarquia

Classe de CImageList

Conceitos

O MFC exemplos ROWLIST