Partilhar via


Classe CColorDialog

Permite incorporar uma caixa de diálogo seleção de cor em seu aplicativo.

class CColorDialog : public CCommonDialog

Comentários

A CColorDialog objeto é uma caixa de diálogo com uma lista de cores são definidas para o sistema de exibição. O usuário pode selecionar ou criar uma cor específica da lista, o que é então relatada volta ao aplicativo quando sai da caixa de diálogo.

Para construir um CColorDialog objeto, use o construtor fornecido ou derivar uma nova classe e use sua própria construtor personalizado.

Depois que a caixa de diálogo tenha sido construída, você pode conjunto ou modificar quaisquer valores no m_cc estrutura ao inicializar os valores dos controles da caixa de diálogo.The m_cc estrutura é do tipo CHOOSECOLOR.

Após inicializar controles da caixa de diálogo, chame o DoModal função de membro para exibir a caixa de diálogo e permitir que o usuário selecionar uma cor. DoModal Retorna a seleção do usuário de (OK) qualquer da caixa de diálogoIDOK) ou em Cancelar (IDCANCEL) botão.

If DoModal Retorna IDOK, você pode usar um dos CColorDialog's funções de membro para recuperar as informações de entrada pelo usuário.

Você pode usar o Windows CommDlgExtendedError função para determinar se ocorreu um erro durante a inicialização da caixa de diálogo e para obter mais informações sobre o erro.

CColorDialog conta com o arquivo Commdlg.dll que acompanha o Windows versões 3.1 e posteriores.

Para personalizar a caixa de diálogo, derivar uma classe de CColorDialog, fornecer um modelo de diálogo personalizada e adicione um MAP da mensagem a processo mensagens de notificação de controles estendidas. As mensagens não processadas devem ser passadas para a classe base.

Personalizando a função de gancho não é necessária.

Observação:

Em algumas instalações a CColorDialog objeto não será exibida com um plano de fundo cinza, se você tiver usado a estrutura para tornar outros CDialog objetos de cinza.

Para obter mais informações sobre como usar CColorDialog, consulte Classes de caixa de diálogo comum

Requisitos

Cabeçalho: afxdlgs.h

Anotações Developer Dispositivo Inteligente

Essa classe só é suportada no SDK do Windows CE Standard.É não suporte no Windows Mobile Pocket PC ou Smartphone plataformas.

Versão do dispositivo inteligenteClasse CColorDialog não suporta os seguintes métodos:

Consulte também

Tarefas

MDI exemplo: Demonstra MDI sem usar a arquitetura de documento/Exibir

Exemplo DRAWCLI: Ilustra a integração do Active suporte de contêiner com recursos específicos do aplicativo

Referência

Classe CCommonDialog

Gráfico de hierarquia

Outros recursos

CColorDialog membros