Classe CVSListBox

A CVSListBox classe suporta um controlo de lista editável.

Sintaxe

class CVSListBox : public CVSListBoxBase

Membros

Construtores Públicos

Métodos Públicos

Métodos Protegidos

Observações

A CVSListBox classe fornece um conjunto de botões de edição que permitem ao utilizador criar, modificar, eliminar ou reorganizar os itens num controlo de lista.

Segue-se uma imagem do controlo de lista editável. A segunda entrada da lista, intitulada "Item2", é selecionada para edição.

Se usar o editor de recursos para adicionar um controlo de lista editável, repare que o painel Toolbox do editor não fornece um controlo de lista editável pré-definido. Em vez disso, adicione um controlo estático, como o controlo Group Box . A estrutura utiliza o controlo estático como marcador de posição para especificar o tamanho e a posição do controlo da lista editável.

Para usar um controlo de lista editável num modelo de caixa de diálogo, declare uma CVSListBox variável na sua classe de caixa de diálogo. Para suportar a troca de dados entre a variável e o controlo, defina uma DDX_Control entrada de macro no DoDataExchange método da caixa de diálogo. Por defeito, o controlo de lista editável é criado sem botões de edição. Use o método herdado CVSListBoxBase::SetStandardButtons para ativar os botões de edição.

Para mais informações, consulte o diretório Samples, os New Controls ficheiros de exemplo, Page3.cpp e Page3.h.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CStatic

CVSListBoxBase

CVSListBox

Requerimentos

Cabeçalho: afxvslistbox.h

CVSListBox::AddItem

Adiciona uma cadeia a um controlo de lista.

virtual int AddItem(
    const CString& strIext,
    DWORD_PTR dwData=0,
    int iIndex=-1);

Parâmetros

StrIext
[dentro] Uma referência a uma corda.

dwData
[dentro] Um valor específico de 32 bits da aplicação associado à cadeia. O valor padrão é 0.

iIndex
[dentro] O índice baseado em zero da posição que irá manter a corda. Se o parâmetro iIndex for -1, a cadeia é adicionada ao final da lista. O valor padrão é -1.

Valor de retorno

O índice baseado em zero da posição da cadeia no controlo da lista.

Observações

Use o método CVSListBox::GetItemData para recuperar o valor especificado pelo parâmetro dwData . Este valor pode ser um inteiro específico da aplicação ou um ponteiro para outros dados.

CVSListBox::CVSListBox

Constrói um CVSListBox objeto.

CVSListBox();

Valor de retorno

Observações

CVSListBox::EditarItem

Inicia uma operação de edição no texto de um item de controlo de lista.

virtual BOOL EditItem(int iIndex);

Parâmetros

iIndex
[dentro] Índice baseado em zero de um item de controlo de lista.

Valor de retorno

TRUE se a operação de edição começar com sucesso; caso contrário, FALSO.

Observações

O utilizador inicia uma operação de edição quer fazendo duplo clique no rótulo de um item, quer pressionando a tecla F2 ou ESPAÇO quando um elemento tem o foco.

CVSListBox::GetCount

Recupera o número de cadeias num controlo de lista editável.

virtual int GetCount() const;

Valor de retorno

O número de itens na lista controla.

Observações

Note que a contagem é um acima do valor do índice do último item porque o índice é baseado em zero.

CVSListBox::GetItemData

Recupera um valor específico de 32 bits da aplicação associado a um item de controlo de lista editável.

virtual DWORD_PTR GetItemData(int iIndex) const;

Parâmetros

iIndex
[dentro] O índice baseado em zero de um item de controlo de lista editável.

Valor de retorno

O valor de 32 bits associado ao item especificado.

Observações

Use o método CVSListBox::SetItemData ou CVSListBox::AddItem para associar o valor de 32 bits ao item de controlo da lista. Este valor pode ser um inteiro específico da aplicação ou um ponteiro para outros dados.

CVSListBox::GetItemText

Recupera o texto de um item de controlo de lista editável.

virtual CString GetItemText(int iIndex) const;

Parâmetros

iIndex
[dentro] O índice baseado em zero de um item de controlo de lista editável.

Valor de retorno

Um objeto CString que contém o texto do item especificado.

Observações

CVSListBox::GetListHwnd

Devolve o handle ao controlo atual de vista de lista embutido.

virtual HWND GetListHwnd() const;

Valor de retorno

Um handle para o controlo de vista de lista embutido.

Observações

Use este método para recuperar um handle para o controlo de vista de lista embutido que suporta a CVSListBox classe.

CVSListBox::GetSelItem

Recupera o índice baseado em zero do item atualmente selecionado num controlo de lista editável.

virtual int GetSelItem() const;

Valor de retorno

Se este método for bem-sucedido, o índice em base zero do item atualmente selecionado; caso contrário, -1.

Observações

CVSListBox::RemoveItem

Remove um item de um controlo de lista editável.

virtual BOOL RemoveItem(int iIndex);

Parâmetros

iIndex
[dentro] O índice baseado em zero de um item de controlo de lista editável.

Valor de retorno

TRUE se o item especificado for removido; caso contrário, FALSO.

Observações

CVSListBox::SelectItem

Seleciona uma cadeia de controlo de lista editável.

virtual BOOL SelectItem(int iItem);

Parâmetros

iItem
[dentro] O índice baseado em zero de um item de controlo de lista editável.

Valor de retorno

TRUE se este método for bem-sucedido; caso contrário, FALSO.

Observações

Este método seleciona o item especificado e, se for necessário, faz o movimento do item aparecer na vista.

CVSListBox::SetItemData

Associa um valor específico de 32 bits da aplicação a um item de controlo de lista editável.

virtual void SetItemData(
    int iIndex,
    DWORD_PTR dwData);

Parâmetros

iIndex
[dentro] O índice baseado em zero de um item de controlo de lista editável.

dwData
[dentro] Um valor de 32 bits. Este valor pode ser um inteiro específico da aplicação ou um ponteiro para outros dados.

Observações

Consulte também

Gráfico de Hierarquia
Classes