Classe CListCtrl

Artigo
06/10/2015

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

Nome	Descrição
CListCtrl::CListCtrl	Constrói um objeto de CListCtrl .

Mé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.