Partilhar via


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

hfshke78.collapse_all(pt-br,VS.110).gifConstrutores public

Nome

Descrição

CListCtrl::CListCtrl

Constrói um objeto de CListCtrl .

hfshke78.collapse_all(pt-br,VS.110).gifMétodos públicos

Nome

Descrição

CListCtrl::ApproximateViewRect

Determina a largura e altura necessária para exibir os itens de um controle de exibição de lista.

CListCtrl::Arrange

Alinha itens em uma grade.

CListCtrl::CancelEditLabel

Cancelar a operação de edição de texto do item.

CListCtrl::Create

Cria um controle de lista e anexá-la a um objeto de CListCtrl .

CListCtrl::CreateDragImage

Cria uma lista de imagem da direita para um item especificado.

CListCtrl::CreateEx

Cria um controle de lista com os estilos estendidos o windows especificados e anexá-la a um objeto de CListCtrl .

CListCtrl::DeleteAllItems

Exclui todos os itens do controle.

CListCtrl::DeleteColumn

Exclui uma coluna de controle de exibição de lista.

CListCtrl::DeleteItem

Excluir um item do controle.

CListCtrl::DrawItem

Chamado quando uma aparência visual de alterações de controle do proprietário.

CListCtrl::EditLabel

Inicia o edição in-loco de texto de um item.

CListCtrl::EnableGroupView

Habilita ou desabilita se os itens em um controle de exibição de lista exibe como um grupo.

CListCtrl::EnsureVisible

Garante que um item é visível.

CListCtrl::FindItem

Procura um item de exibição de lista que especifica características.

CListCtrl::GetBkColor

Recupera a cor do plano de fundo de um controle de exibição de lista.

CListCtrl::GetBkImage

Recupera uma imagem de plano de fundo atual de um controle de exibição de lista.

CListCtrl::GetCallbackMask

Recupera a máscara de retorno de chamada para um controle de exibição de lista.

CListCtrl::GetCheck

Recupera o status atual de exibição de imagem de estado associada a um item.

CListCtrl::GetColumn

Recupera os atributos de uma coluna de controle.

CListCtrl::GetColumnOrderArray

Recupera a ordem de coluna (esquerda para a direita) de um controle de exibição de lista.

CListCtrl::GetColumnWidth

Obtém a largura de uma coluna no visualizador de relatório ou no modo de exibição de lista.

CListCtrl::GetCountPerPage

Calcula o número de itens que podem caber verticalmente em um controle de exibição de lista.

CListCtrl::GetEditControl

Recupera a alça de controle edit usado para editar o texto de um item.

CListCtrl::GetEmptyText

Retorna a cadeia de caracteres para exibir se o controle atual de exibição de lista está vazia.

CListCtrl::GetExtendedStyle

Recupera os estilos estendidos atual de um controle de exibição de lista.

CListCtrl::GetFirstSelectedItemPosition

Retorna a posição do primeiro item selecionado de exibição de lista em um controle de exibição de lista.

CListCtrl::GetFocusedGroup

Recupera o grupo que tem o foco do teclado no controle atual de exibição de lista.

CListCtrl::GetGroupCount

Retorna o número de grupos no controle atual de exibição de lista.

CListCtrl::GetGroupInfo

Obtém informações para um grupo de controle específico de exibição de lista.

CListCtrl::GetGroupInfoByIndex

Recupera informações sobre um grupo especificado no controle atual de exibição de lista.

CListCtrl::GetGroupMetrics

Recupera métricas de um grupo.

CListCtrl::GetGroupRect

Recupera o retângulo delimitador de um grupo especificado no controle atual de exibição de lista.

CListCtrl::GetGroupState

Recupera o estado de um grupo especificado no controle atual de exibição de lista.

CListCtrl::GetHeaderCtrl

Recupera o controle de cabeçalho de um controle de exibição de lista.

CListCtrl::GetHotCursor

Recupera o cursor usado quando o rastreamento quente é habilitado para um controle de exibição de lista.

CListCtrl::GetHotItem

Recupera o item de exibição de lista atualmente sob o cursor.

CListCtrl::GetHoverTime

Recupera hora atuais de foco de um controle de exibição de lista.

CListCtrl::GetImageList

Recupera a alça de uma lista de imagem usada desenhando itens de exibição de lista.

CListCtrl::GetInsertMark

Recupera a posição atual da marca de inserção.

CListCtrl::GetInsertMarkColor

Recupera a cor atual da marca de inserção.

CListCtrl::GetInsertMarkRect

Recupera o retângulo que limita o ponto de inserção.

CListCtrl::GetItem

Recupera os atributos de um item de exibição de lista.

CListCtrl::GetItemCount

Retorna o número de itens em um controle de exibição de lista.

CListCtrl::GetItemData

Recupera o valor específico do aplicativo associado com um item.

CListCtrl::GetItemIndexRect

Recupera o retângulo delimitador para todos ou parte de um subitens atual no controle de exibição de lista.

CListCtrl::GetItemPosition

Retorna a posição de um item de exibição de lista.

CListCtrl::GetItemRect

Recupera o retângulo delimitador de um item.

CListCtrl::GetItemSpacing

Calcula o espacejamento entre itens no controle atual de exibição de lista.

CListCtrl::GetItemState

Recupera o estado de um item de exibição de lista.

CListCtrl::GetItemText

Recupera o texto de um item ou de um subitens de exibição de lista.

CListCtrl::GetNextItem

Procura um item de exibição de lista com propriedades específicas e especificada com relação a um item especificado.

CListCtrl::GetNextItemIndex

Retorna o índice do item no controle atual de exibição de lista que tem um conjunto específico de propriedades.

CListCtrl::GetNextSelectedItem

Retorna o índice de uma posição do item de exibição de lista, e a posição do item selecionado seguinte de exibição de lista para iterar.

CListCtrl::GetNumberOfWorkAreas

Retorna o número atual de áreas que funciona para um controle de exibição de lista.

CListCtrl::GetOrigin

Recupera a origem de exibição atual para um controle de exibição de lista.

CListCtrl::GetOutlineColor

Recupera a cor da borda de um controle de exibição de lista.

CListCtrl::GetSelectedColumn

Retorna o índice da coluna selecionada na lista de controle.

CListCtrl::GetSelectedCount

Retorna o número de itens selecionados no controle de exibição de lista.

CListCtrl::GetSelectionMark

Recupera a marca de seleção de um controle de exibição de lista.

CListCtrl::GetStringWidth

Determina a largura da coluna mínima necessária exibir qualquer cadeia de caracteres especificados.

CListCtrl::GetSubItemRect

Recupera o retângulo delimitador de um item em um controle de exibição de lista.

CListCtrl::GetTextBkColor

Recupera a cor do plano de fundo do texto de um controle de exibição de lista.

CListCtrl::GetTextColor

Recupera o texto da cor de um controle de exibição de lista.

CListCtrl::GetTileInfo

Recupera informações sobre um elemento em um controle de exibição de lista.

CListCtrl::GetTileViewInfo

Recupera informações sobre um controle de exibição de lista na exibição lado a lado.

CListCtrl::GetToolTips

Recupera o controle de dica de ferramenta que o controle de list view usa para exibir as dicas de ferramentas.

CListCtrl::GetTopIndex

Retorna o índice do item visível o nível mais alto.

CListCtrl::GetView

Obtém a exibição de controle de exibição de lista.

CListCtrl::GetViewRect

Recupera o retângulo delimitador de todos os itens no controle de exibição de lista.

CListCtrl::GetWorkAreas

Recupera as áreas de trabalho atual de um controle de exibição de lista.

CListCtrl::HasGroup

Determina se o controle de exibição de lista possui o grupo especificado.

CListCtrl::HitTest

Determina qual item de exibição de lista está na posição especificada.

CListCtrl::InsertColumn

Insere uma nova coluna em um controle de exibição de lista.

CListCtrl::InsertGroup

Insere um grupo no controle de exibição de lista.

CListCtrl::InsertGroupSorted

Insere o grupo especificado em uma lista ordenada de grupos.

CListCtrl::InsertItem

Insere um novo item em um controle de exibição de lista.

CListCtrl::InsertMarkHitTest

Retorna o ponto de inserção mais próximo a um ponto específico.

CListCtrl::IsGroupViewEnabled

Determina se o modo de exibição de grupo está habilitada para um controle de exibição de lista.

CListCtrl::IsItemVisible

Indica se um item específico no controle atual de exibição de lista é visível.

CListCtrl::MapIDToIndex

Mapeia o ID exclusivo de um item no controle atual de exibição de lista para um índice.

CListCtrl::MapIndexToID

Mapeia o índice de um item no controle atual de exibição de lista a uma identificação exclusiva

CListCtrl::MoveGroup

Move o grupo especificado.

CListCtrl::MoveItemToGroup

Move o grupo especificado para índice com base zero especificado de controle de exibição de lista.

CListCtrl::RedrawItems

Força um controle de exibição de lista para redesenhar um intervalo de itens.

CListCtrl::RemoveAllGroups

Remove todos os grupos de um controle de exibição de lista.

CListCtrl::RemoveGroup

Remove o grupo de controle específico de exibição de lista.

CListCtrl::Scroll

Rola o conteúdo de um controle de exibição de lista.

CListCtrl::SetBkColor

Define a cor do plano de fundo do controle de exibição de lista.

CListCtrl::SetBkImage

Define a imagem de plano de fundo atual de um controle de exibição de lista.

CListCtrl::SetCallbackMask

Define a máscara de retorno de chamada para um controle de exibição de lista.

CListCtrl::SetCheck

Define o status atual de exibição de imagem de estado associada a um item.

CListCtrl::SetColumn

Defina os atributos de uma coluna de exibição de lista.

CListCtrl::SetColumnOrderArray

Define a ordem de coluna (esquerda para a direita) de um controle de exibição de lista.

CListCtrl::SetColumnWidth

Altera a largura de uma coluna no visualizador de relatório ou no modo de exibição de lista.

CListCtrl::SetExtendedStyle

Define estilos estendidos atual de um controle de exibição de lista.

CListCtrl::SetGroupInfo

Define informações para o grupo especificado de um controle de exibição de lista.

CListCtrl::SetGroupMetrics

Define métricas do grupo de um controle de exibição de lista.

CListCtrl::SetHotCursor

Define o cursor usado quando o rastreamento quente é habilitado para um controle de exibição de lista.

CListCtrl::SetHotItem

Define o item atual quente de um controle de exibição de lista.

CListCtrl::SetHoverTime

Defina a hora atuais de foco de um controle de exibição de lista.

CListCtrl::SetIconSpacing

Define o espacejamento entre ícones em um controle de exibição de lista.

CListCtrl::SetImageList

Atribui uma lista de imagem a um controle de exibição de lista.

CListCtrl::SetInfoTip

Define o texto de tooltip.

CListCtrl::SetInsertMark

Define o ponto de inserção para a posição definida.

CListCtrl::SetInsertMarkColor

Define a cor do ponto de inserção.

CListCtrl::SetItem

Define alguns ou todos os atributos de um item de exibição de lista.

CListCtrl::SetItemCount

Preparar um controle de exibição de lista adicionando um grande número de itens.

CListCtrl::SetItemCountEx

Define a contagem de item para um controle virtual de exibição de lista.

CListCtrl::SetItemData

Defina o valor específico do aplicativo de item.

CListCtrl::SetItemIndexState

Define o estado de um item no controle atual de exibição de lista.

CListCtrl::SetItemPosition

Move um item em uma posição especificada em um controle de exibição de lista.

CListCtrl::SetItemState

Altera o estado de um item em um controle de exibição de lista.

CListCtrl::SetItemText

Altera o texto de um item ou de um subitens de exibição de lista.

CListCtrl::SetOutlineColor

Define a cor da borda de um controle de exibição de lista.

CListCtrl::SetSelectedColumn

Definir a coluna selecionada de controle de exibição de lista.

CListCtrl::SetSelectionMark

Define a marca de seleção de um controle de exibição de lista.

CListCtrl::SetTextBkColor

Define a cor do plano de fundo do texto em um controle de exibição de lista.

CListCtrl::SetTextColor

Define a cor do texto de um controle de exibição de lista.

CListCtrl::SetTileInfo

Define informações para um quadro de controle de exibição de lista.

CListCtrl::SetTileViewInfo

Define informações que um controle de exibição de lista usa no modo de exibição lado a lado.

CListCtrl::SetToolTips

Define o tipo de controle tooltip que o controle de list view usará para exibir as dicas de ferramentas.

CListCtrl::SetView

Define a exibição de controle de exibição de lista.

CListCtrl::SetWorkAreas

Define uma área onde os ícones podem ser exibidos em um controle de exibição de lista.

CListCtrl::SortGroups

Classifica os grupos de um controle de exibição de lista com uma função definida pelo usuário.

CListCtrl::SortItems

Os itens de exibição de lista os tipos que usam uma comparação application-defined funcionam.

CListCtrl::SortItemsEx

Os itens de exibição de lista os tipos que usam uma comparação application-defined funcionam.

CListCtrl::SubItemHitTest

Determina qual item de lista modo de exibição, se houver, está em uma posição determinada.

CListCtrl::Update

Força o controle para redesenhar um item especificado.

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