Compartilhar via


Classe CCheckListBox

Fornece a funcionalidade de uma caixa de lista de verificação do Windows.

class CCheckListBox : public CListBox

Comentários

Uma "caixa de lista de verificação" exibe uma lista de itens, sistema autônomo nomes de arquivo.Cada item da lista tem uma caixa de seleção próxima a ele que o usuário pode verificar ou desmarcar.

CCheckListBox é somente para controles desenhados pelo proprietário porque a lista contém mais de seqüências de caracteres de texto. Em sua forma mais simples, uma caixa de lista de verificação contém seqüências de caracteres de texto e caixas de seleção, mas não é necessário para que todo o texto.Por exemplo, você poderia ter uma lista de bitmaps pequenos com uma caixa de seleção próxima a cada item.

Para criar sua própria caixa de lista de verificação, você deve derivar sua própria classe de CCheckListBox. Para derivar sua própria classe, escrever um construtor para a classe derivada, então telefonar Criar.

Se você quiser controlar 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 manipulador de mensagens e entrada de MAP da mensagem para a classe pai para cada mensagem.

Cada entrada de MAP da mensagem possui o seguinte formato:

ON_Notification( id, memberFxn )

em que id Especifica a ID da janela filho do controle enviando a notificação e memberFxn é o nome da função de membro pai que você tenha escrito para manipular a notificação.

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

afx_msg void memberFxn**( );**

Há apenas uma entrada de MAP da mensagem pertinentes especificamente CCheckListBox (mas consulte também as entradas de MAP da mensagem para CListBox):

  • ON_CLBN_CHKCHANGE   O usuário alterou o estado da caixa de seleção do item.

Se sua caixa de lista de verificação é uma caixa de lista de verificação padrão (uma lista de seqüências de caracteres com as caixas de seleção tamanho padrão para a esquerda de cada), você pode usar o padrão de CCheckListBox::DrawItem para desenhar a caixa de lista de verificação.Caso contrário, você deve substituir o CListBox::CompareItem função e o CCheckListBox::DrawItem and CCheckListBox::MeasureItem funções.

Você pode criar uma caixa de lista de verificação a partir de um modelo de caixa de diálogo ou diretamente em seu código.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Tarefas

Exemplo TSTCON: Controlarar ActiveX Teste recipiente

Referência

Classe CListBox

Gráfico de hierarquia

Classe CListBox

Outros recursos

CCheckListBox membros