CListBox

A classe CListBox fornece a funcionalidade de uma caixa de listagem do Windows. Uma caixa de listagem exibe uma lista de itens, como nomes de arquivos que o usuário pode exibir e selecionar.

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

Você pode criar uma caixa de listagem ou de um modelo de caixa de diálogo diretamente no seu código. Para criá-lo diretamente, construir o objeto CListBox e, em seguida, chame a criar função de membro para criar o Controlarar de caixa de listagem do Windows e anexá-lo para o objeto CListBox . Para usar uma caixa de listagem em um modelo de diálogo, declare uma variável de caixa de lista em sua classe de caixa de diálogo e, em seguida, use DDX_Control na função de DoDataExchange de sua classe caixa de diálogo Conectar-se a variável de membro ao Controlarar. (ClassWizard faz isso para você automaticamente quando você adicionar uma variável de controle para sua classe de caixa de diálogo.)

Construção pode ser um processo de uma etapa em uma classe derivada CListBox. Gravar um construtor para a classe derivada e chamar criar de dentro do Construtor.

Se você deseja manipular mensagens de notificação do Windows enviadas por uma caixa de listagem para seu pai (geralmente uma classe derivada de CDialog), adicionar uma função de membro de mapa de mensagens entrada e o manipulador de mensagem para a classe pai para cada mensagem.

Cada entrada de mapa de Mensagemens assume a seguinte forma:

ON_Notificação( id, memberFxn void )

onde id especifica a identificação de janela filho do Controlarar caixa de listagem enviar a notificação e memberFxn é o nome da função de membro pai que você escreveu para manipular a notificação.

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

afx_msg privatevoid memberFxn( );

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

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

Se você criar um objeto de CListBox dentro de uma janela, talvez você precise destruir o objeto CListBox . Se você criar o objeto CListBox na pilha, ele é destruído automaticamente. Se você criar o objeto CListBox no heap usando a função de novo , você deve chamar Excluir no objeto para destruí-lo quando o usuário fecha a janela pai.

Se você alocar qualquer memória no objeto CListBox , substituir o destruidor CListBox descartar da alocação.

# include lt;afxwin.h>

Membros da classeClasse base | Gráfico de hierarquia

Amostra  Exemplo do MFC CTRLTEST

Co&nsulte tambémnbsp;CWnd, CButton, CComboBox, CEdit, CScrollBar, CStatic

Index