Classe de CColorDialog

Artigo
02/25/2013

Permite que você insira uma caixa de diálogo de cor- seleção em seu aplicativo.

class CColorDialog : public CCommonDialog

Membros

Construtores public

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

Métodos públicos

Nome	Descrição
CColorDialog::DoModal	Exibe uma caixa de diálogo de cor e permite que o usuário faça uma seleção.
CColorDialog::GetColor	Retorna uma estrutura de COLORREF que contém os valores de cor selecionada.
CColorDialog::GetSavedCustomColors	Recupera as cores personalizados criados pelo usuário.
CColorDialog::SetCurrentColor	Força a cor de seleção atual para a cor especificada.

Métodos protegidos

Nome	Descrição
CColorDialog::OnColorOK	Substituição para validar a cor inserida na caixa de diálogo.

Membros públicos de dados

Nome	Descrição
CColorDialog::m_cc	Uma estrutura usada para personalizar as configurações da caixa de diálogo.

Comentários

Um objeto de CColorDialog é um caixa de diálogo com uma lista de cores que são definidas para o sistema de exibição.O usuário pode selecionar ou criar uma cor específico na lista, que é relatada de volta para o aplicativo quando a caixa de diálogo será encerrado.

Para criar um objeto de CColorDialog , usando o construtor fornecido ou derivar uma nova classe e usar seu próprio construtor personalizado.

Uma vez que a caixa de diálogo foi construída, você pode definir ou modificar os valores na estrutura dem_cc para inicializar valores dos controles da caixa de diálogo.A estrutura de m_cc é do tipo CHOOSECOLOR.

Após inicializado os controles da caixa de diálogo, chame a função de membro de DoModal para exibir a caixa de diálogo e para permitir que o usuário selecione uma cor.DoModal retorna a seleção do usuário de OK da caixa de diálogo (IDOK) ou um botão cancelar (IDCANCEL).

Se DoModal retorna IDOK, você pode usar uma das funções de membro de CColorDialog para recuperar informações de entrada pelo usuário.

Você pode usar a função de CommDlgExtendedError do windows para determinar se um erro ocorrer durante a inicialização da caixa de diálogo e para aprender mais sobre o erro.

CColorDialog depende do arquivo de COMMDLG.DLL que vem com versões 3,1 e posterior do windows.

Para personalizar a caixa de diálogo, derive uma classe de CColorDialog, forneça um modelo personalizado da caixa de diálogo, e adicionar um mapa de mensagens para processar as notificações dos controles estendidos.Todas as mensagens não processadas devem ser passada para a classe base.

Personalizar a função de gancho não é necessário.

Observação
Em algumas instalações o objeto de CColorDialog não exibirá com um plano de fundo cinza se você usou a estrutura para fazer o outro cinza de objetos de CDialog .