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."
Cada item aparece como um completo-tamanho ícone (32 x 32 pixels) com um rótulo abaixo dela. O usuário pode arrastar os itens para qualquer local na janela de modo de exibição lista.
Cada item aparece como um ícone pequeno (16 x 16 pixels) com a etiqueta à direita dele. O usuário pode arrastar os itens para qualquer local na janela de modo de exibição lista.
Cada item aparece como um ícone pequeno com um rótulo à direita dele. Itens são organizados em colunas e não podem ser arrastadas para qualquer local na janela de modo de exibição lista.
Cada item aparece em sua própria linha, com adicionais informações organizadas em colunas à direita. A coluna mais à esquerda contém o pequeno ícone e o rótulo e colunas subseqüentes contêm subitens conforme especificado pelo aplicativo. Um Controlarar de cabeçalho incorporado (classe CHeaderCtrl) implementa essas colunas. Para obter mais informações sobre o Controlarar de cabeçalho e colunas em um modo de exibição de relatório, consulte CListCtrl usando: Adicionando colunas ao Controlarar (Exibir de Relatar).
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:
Quando habilitado, permite a seleção automática de um item quando o cursor permanece sobre o item por um determinado período de tempo.
Quando habilitado, permite o controle suportar até itens DWORD . Isso é possível, colocando a sobrecarga do gerenciamento de dados do item no aplicativo. Exceto para a seleção de item e informações de foco, todas as informações de item devem ser gerenciadas pela aplicação. Para obter mais informações, consulte usando CListCtrl: controles de lista Virtual.
Quando habilitado, permite rastreamento hot (automático realce do texto do item) e One – ou two – clique em ativação do item realçado.
Quando habilitado, permite arrastar-e-soltar reordenação de colunas em um Controlarar de Exibir de lista. Disponível somente no Exibir de Relatar.
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:
Usado no modo de exibição de ícone para ícones de tamanho.
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 ícone.
Contém imagens de Estado, que são exibidas próximo ao ícone de um item para indicar um estado definido pelo aplicativo.
Usado na Exibir de Relatar para imagens pequenas que aparecem em cada item de Controlarar de cabeçalho.
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 classe | Classe 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