CListCtrl

A classe CListCtrl encapsula a funcionalidade de um "controle de exibição lista," que exibe uma coleção de itens cada consiste em um ícone (em uma lista de imagem) e um rótulo. Além de um ícone e rótulo, cada item pode ter informações exibidas em colunas à direita do ícone e rótulo. Esse Controlarar (e, portanto, a classe CListCtrl ) está disponível somente para programas em executando no Windows 95 e Windows NT versão 3.51 e posterior.

A seguir está uma breve visão sobre a classe CListCtrl . Para uma discussão detalhada, conceitual, consulte Usando CListCtrl e Controle tópicos no Guia do programador do Visual C++.

Modos de exibição

Controles de exibição de lista podem exibir seu conteúdo de quatro maneiras diferentes, chamadas "pontos de vista."

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

Estilos estendidos

Juntamente com os estilos de lista padrão, classe CListCtrl suporta um conjunto grande de estilos estendidos, fornecendo funcionalidade enriquecida. Alguns exemplos desta funcionalidade:

Para obter informações sobre como usar esses novos estendido estilos, consulte CListCtrl usando: Alterar estilos de Controlarar de lista.

Itens e subitens

Cada item em um Controlarar de Exibir de lista consiste em um ícone (em uma lista de imagem), um rótulo, um estado atual e um valor definido pelo aplicativo (referido como "dados do item"). Um ou mais subitens também podem ser associados com cada item. Um "subitem" é uma Cadeia 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 Controlarar de Exibir de lista devem ter o mesmo número de subitens.

Classe CListCtrl fornece várias funções para inserir, excluir, encontrar e modificar esses itens. Para obter mais informações, consulte CListCtrl::GetItem, CListCtrle CListCtrl::FindItem, CListCtrl usando: Adicionando itens ao controle, e usando CListCtrl: rolagem, organizando, classificando e Localizando em controles de lista.

Por padrão, o Controlarar de Exibir de lista é responsável por armazenar os atributos de ícone e texto de um item. No entanto, além destes tipos de item, classe CListCtrl suporta "itens de retorno de chamada." Um "item de retorno de chamada" é uma exibição de lista item para o qual o aplicativo — em vez do Controlarar — armazena o texto, ícone ou ambos. Uma máscara de retorno de chamada é usada para especificar quais item atributos (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. Itens de retorno de chamada são úteis quando seu aplicativo já mantém algumas dessas informações. Para obter mais informações, consulte CListCtrl:: GetCallbackMask e CListCtrl usando: 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 desistir definidos Estados para 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 Controlarar de Exibir de lista. Cada Controlarar de Exibir de lista pode ter até quatro tipos diferentes de listas de imagem:

Por padrão, um Controlarar de Exibir de lista destrói as listas imagem atribuídas a ele quando ele for destruído; no entanto, o desenvolvedor pode personalizar esse comportamento, destruindo cada lista de imagens quando já não é utilizado, conforme determinado pelo aplicativo. Para obter mais informações, consulte CListCtrl usando: itens de lista e listas de imagem e CListCtrl usando: itens de lista e listas de imagem.

# include lt;afxcmn.h>

Membros da classeClasse base | Gráfico de hierarquia

&Nbsp amostras; MFC exemplo DAOTABLE | MFC exemplo HTTPSVR | MFC exemplo LISTHDR | MFC exemplo ROWLIST | MFC exemplo DBVLIST

Co&nsulte tambémnbsp;CImageList

Index