Compartilhar via


Classe CCheckListBox

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.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CListBox

CCheckListBox

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CListBox

Gráfico da hierarquia

Classe CListBox

Conceitos

Exemplo TSTCON MFC