Classe CListBox

Artigo
06/10/2015

Fornece a funcionalidade de uma caixa de listagem do windows.

class CListBox : public CWnd

Membros

Construtores public

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

Métodos públicos

Nome	Descrição
CListBox::AddString	Adiciona uma cadeia de caracteres em uma caixa de listagem.
CListBox::CharToItem	Substituição para fornecer WM_CHAR personalizado que manipula para as caixas de listagem do proprietário que não têm cadeias de caracteres.
CListBox::CompareItem	Chamado pela estrutura para determinar a posição de um novo item em uma caixa de lista classificada do proprietário.
CListBox::Create	Cria o caixa de listagem e anexar-las ao objeto de CListBox .
CListBox::DeleteItem	Chamado pela estrutura quando o usuário excluir um item de uma caixa de lista do proprietário.
CListBox::DeleteString	Exclui uma cadeia de caracteres de uma caixa de listagem.
CListBox::Dir	Adiciona nomes de arquivos, unidades, ou ambas o diretório atual para uma caixa de listagem.
CListBox::DrawItem	Chamado pela estrutura quando uma aparência visual de uma caixa de lista do proprietário alterar.
CListBox:: FindString	Procura uma cadeia de caracteres em uma caixa de listagem.
CListBox::FindStringExact	Localiza a primeira cadeia de caracteres da caixa de listagem que corresponde a uma cadeia de caracteres especificada.
CListBox::GetAnchorIndex	Retorna o índice com base zero de item atual de âncora em uma caixa de listagem.
CListBox::GetCaretIndex	Determina o índice do item que tem o retângulo de foco em uma caixa de listagem múltipla seleção.
CListBox::GetCount	Retorna o número de cadeias de caracteres em uma caixa de listagem.
CListBox::GetCurSel	Retorna o índice com base zero de cadeia de caracteres atualmente selecionada em uma caixa de listagem.
CListBox::GetHorizontalExtent	Retorna a largura em pixels que uma caixa de listagem pode ser rolada horizontalmente.
CListBox::GetItemData	Retorna o valor de 32 bits associado com o item da caixa de listagem.
CListBox::GetItemDataPtr	Retorna um ponteiro para um item da caixa de listagem.
CListBox::GetItemHeight	Determina a altura dos itens em uma caixa de listagem.
CListBox::GetItemRect	Retorna o retângulo delimitador do item da caixa de listagem que é exibido no momento.
CListBox::GetListBoxInfo	Retorna o número de itens pela coluna.
CListBox::GetLocale	Recupera a identificação de localidade para uma caixa de listagem.
CListBox::GetSel	Retorna o estado de seleção de um item da caixa de listagem.
CListBox::GetSelCount	Retorna o número de cadeias de caracteres selecionadas no momento em uma caixa de listagem múltipla seleção.
CListBox::GetSelItems	Retorna os índices de cadeias de caracteres selecionadas no momento em uma caixa de listagem.
CListBox::GetText	Copiar um item da caixa de listagem em um buffer.
CListBox::GetTextLen	Retorna o tamanho em bytes de um item da caixa de listagem.
CListBox::GetTopIndex	Retorna o índice da primeira cadeia de caracteres visível em uma caixa de listagem.
CListBox::InitStorage	Preallocates blocos de memória para itens e cadeias de caracteres da caixa de listagem.
CListBox::InsertString	Insere uma cadeia de caracteres em um local específico em uma caixa de listagem.
CListBox::ItemFromPoint	Retorna o índice do item da caixa de listagem mais próximo um ponto.
CListBox::MeasureItem	Chamado pela estrutura quando uma caixa de lista do proprietário é criada para determinar dimensões da caixa de listagem.
CListBox::ResetContent	Limpa todas as entradas de uma caixa de listagem.
CListBox::SelectString	Procura por e selecionam uma cadeia de caracteres em uma caixa de listagem de única seleção.
CListBox::SelItemRange	Seleciona ou desmarca um intervalo de cadeias de caracteres em uma caixa de listagem múltipla seleção.
CListBox::SetAnchorIndex	Define a âncora em uma caixa de listagem múltipla seleção para iniciar uma seleção estendido.
CListBox::SetCaretIndex	Define o retângulo de foco para o item no índice especificado em uma caixa de listagem múltipla seleção.
CListBox::SetColumnWidth	Defina a largura da coluna de uma caixa de listagem com várias colunas.
CListBox::SetCurSel	Seleciona uma cadeia de caracteres da caixa de listagem.
CListBox::SetHorizontalExtent	Defina a largura em pixels que uma caixa de listagem pode ser rolada horizontalmente.
CListBox::SetItemData	Defina o valor de 32 bits associado com o item da caixa de listagem.
CListBox::SetItemDataPtr	Define um ponteiro para o item da caixa de listagem.
CListBox::SetItemHeight	Defina a altura dos itens em uma caixa de listagem.
CListBox::SetLocale	Define a identificação de localidade para uma caixa de listagem.
CListBox::SetSel	Seleciona ou desmarca um item da caixa de listagem em uma caixa de listagem múltipla seleção.
CListBox::SetTabStops	Defina as posições de tabulação em uma caixa de listagem.
CListBox::SetTopIndex	Define o índice com base zero da primeira cadeia de caracteres visível em uma caixa de listagem.
CListBox::VKeyToItem	Substituição para fornecer WM_KEYDOWN personalizado que manipula para caixas de listagem com o conjunto de estilo de LBS_WANTKEYBOARDINPUT .

Comentários

Uma caixa de listagem exibe uma lista de itens, como os nomes de arquivo, que o usuário pode exibir e selecione.

Em uma caixa de listagem de única seleção, o usuário pode selecionar somente um item. Em uma caixa de listagem múltipla seleção, um intervalo de itens pode ser selecionado. Quando o usuário seleciona um item, ele é realçado e envia da caixa de listagem uma notificação para a janela pai.

Você pode criar uma caixa de listagem de um modelo na caixa de diálogo ou diretamente no seu código. Para criar diretamente, construir o objeto de CListBox , então chamar a função de membro de Criar para criar o controle de caixa de listagem do windows para e anexá-la ao objeto de CListBox . Para usar uma caixa de listagem em um modelo da caixa de diálogo, para declarar uma variável da caixa de listagem em sua classe da caixa de diálogo, para usar em DDX_Control na função de DoDataExchange de sua classe da caixa de diálogo para se conectar a variável de membro para o controle. (isso é feito automaticamente para você quando você adicionar uma variável de controle à sua classe da caixa de diálogo.)

A compilação pode ser um processo de uma etapa em uma classe derivada de CListBox. Escreva um construtor para a classe derivada e chamar Criar de dentro do construtor.

Se você desejar manipular as notificações do windows enviadas por uma caixa de listagem ao seu pai (geralmente uma classe derivada de CDialog), adicionar uma função de membro de entrada e de mensagem- manipulador de mensagem- mapa para a classe pai para cada mensagem.

Cada entrada de mapa mensagem- tem a seguinte forma:

ON_Notification( id, memberFxn )

onde id especifica a identificação da janela filho do controle de caixa de listagem que envia a notificação e são memberFxn o nome da função de membro que você escreveu pai para trate a notificação.

O protótipo de função do pai é o seguinte:

afx_msg void memberFxn( );

A seguir está uma lista de possíveis entradas de mapa mensagem- e uma descrição dos casos em que poderiam ser enviados ao pai:

ON_LBN_DBLCLK o usuário clica duas vezes em uma cadeia de caracteres em uma caixa de listagem. Somente uma caixa de listagem que tem o estilo de LBS_NOTIFY enviará essa notificação.
ON_LBN_ERRSPACE a caixa de listagem não pode alocar memória suficiente para atender a solicitação.
ON_LBN_KILLFOCUS a caixa de listagem está perdendo o foco de entrada.
ON_LBN_SELCANCEL a seleção atual da caixa de listagem será cancelado. Essa mensagem é enviada somente quando uma caixa de listagem tem o estilo de LBS_NOTIFY .
ON_LBN_SELCHANGE que a seleção na caixa de listagem foi alterado. Essa notificação não é enviada se a seleção é alterada pela função de membro de CListBox::SetCurSel . Essa notificação só se aplica a uma caixa de listagem que tem o estilo de LBS_NOTIFY . Notificação de LBN_SELCHANGE é enviada para uma caixa de listagem múltipla seleção sempre que o usuário pressiona uma tecla de direção, mesmo se a seleção não muda.
ON_LBN_SETFOCUS a caixa de listagem é receber o foco de entrada.
ON_WM_CHARTOITEM uma caixa de lista do proprietário que não tem nenhuma cadeia de caracteres recebe uma mensagem de WM_CHAR .
a caixa de listagem deON_WM_VKEYTOITEM A com o estilo de LBS_WANTKEYBOARDINPUT recebe uma mensagem de WM_KEYDOWN .

Se você criar um objeto de CListBox de uma caixa de diálogo (através de um recurso da caixa de diálogo), o objeto de CListBox é destruído automaticamente quando o usuário fecha a caixa de diálogo.

Se você criar um objeto de CListBox em uma janela, você pode precisar destruir o objeto de CListBox . Se você criar o objeto de CListBox na pilha, é automaticamente destruída. Se você criar o objeto de CListBox no heap usando a função de new , você deve chamar delete no objeto para destrui-lo quando o usuário fecha a janela pai.

Se você atribuir qualquer memória do objeto de CListBox , substitua o destrutor de CListBox para descartar de alocação.