Classe de CCheckListBox

Artigo
02/25/2013

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

class CCheckListBox : public CListBox

Membros

Construtores public

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

Métodos públicos

Nome	Descrição
CCheckListBox::Create	Cria a caixa de lista de verificação do windows e anexá-la ao objeto de CCheckListBox .
CCheckListBox::DrawItem	Chamado pela estrutura quando uma aparência visual de uma caixa de lista do proprietário alterar.
CCheckListBox::Enable	Habilita ou desabilita um item da caixa de lista de verificação.
CCheckListBox::GetCheck	Obtém o estado da caixa de seleção de um item.
CCheckListBox::GetCheckStyle	Obtém o estilo das caixas de seleção do controle.
CCheckListBox::IsEnabled	Determina se um item está habilitado.
CCheckListBox::MeasureItem	Chamado pela estrutura quando uma caixa de listagem com um estilo do proprietário é criada.
CCheckListBox::OnGetCheckPosition	Chamado pela estrutura para obter a posição da caixa de seleção de um item.
CCheckListBox::SetCheck	Define o estado da caixa de seleção de um item.
CCheckListBox::SetCheckStyle	Defina o estilo das caixas de seleção do controle.

Comentários

“Uma caixa de lista de verificação” exibe uma lista de itens, como nomes de arquivo.Cada item na lista possui uma caixa de seleção próxima a ela que o usuário pode verificar ou desmarque.

CCheckListBox é somente para controles proprietário desenhados como a lista contém mais de cadeias de caracteres de texto.Em a sua forma mais simples, uma caixa de lista de verificação contém cadeias de caracteres de texto e caixas de seleção, mas você não precisa ter o texto de qualquer.Por exemplo, você poderia ter uma lista de bitmaps pequenos com uma caixa de seleção ao lado de 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, escreva um construtor para a classe derivada, então chamar Criar.

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:

Notificação**(iddeON_, memberFxn)**

onde id especifica a identificação da janela filho do controle 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_msgvoidmemberFxn**( );**

Há apenas uma entrada de mapa mensagem- que pertencem especificamente a CcheckListBox (mas também consulte as entradas de mapa mensagem- para CListBox):

ON_CLBN_CHKCHANGE o usuário alterou o estado da caixa de seleção de um item.

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

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