ChooseColor

A função ChooseColor cria uma caixa de diálogo comum cor que permite que o usuário selecione uma cor.

(BOOL ChooseColor LPCHOOSECOLOR  lpcc / / ponteiro para estrutura com inicialização / / dados);
 

Parâmetros

lpcc
Ponteiro para uma estrutura CHOOSECOLOR que contém informações usadas para inicializar a caixa de diálogo. Quando ChooseColor retorna, essa estrutura contém informações sobre a seleção de cor do usuário.

Retornar valores

Se o usuário clicar no botão OK da caixa de diálogo, o valor de retorno é diferente de zero. O rgbResult membro da estrutura CHOOSECOLOR contém o valor de cor RGB da cor selecionada pelo usuário.

Se o usuário cancela ou fecha a caixa de diálogo de cor ou se ocorrer um erro, o valor de retorno é zero. Para obter informações de erro estendidas, chamar o CommDlgExtendedError função, que pode retornar uma dos seguinte valores:

CDERR_FINDRESFAILURE CDERR_MEMLOCKFAILURE
CDERR_INITIALIZATION CDERR_NOHINSTANCE
CDERR_LOCKRESFAILURE CDERR_NOHOOK
CDERR_LOADRESFAILURE CDERR_NOTEMPLATE
CDERR_LOADSTRFAILURE CDERR_STRUCTSIZE
CDERR_MEMALLOCFAILURE

Observações

A caixa de diálogo de cor não oferece suporte a paletas. As opções de cores oferecidas pela caixa de diálogo são limitadas às cores do sistema e versões pontilhados dessas cores.

Você pode fornecer um procedimento de gancho de CCHookProc para uma caixa de diálogo de cor . O procedimento de gancho pode Processoar as mensagens enviadas para a caixa de diálogo. Para habilitar um procedimento de gancho, defina o sinalizador CC_ENABLEHOOK in o sinalizadores membro da estrutura CHOOSECOLOR e especificar o endereço do procedimento de gancho na lpfnHook membro.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer a versão 2.0 ou posterior.
Cabeçalho:Declaradas no commdlg.h.
Biblioteca de importação:Use comdlg32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de biblioteca de caixa de diálogo comum, funções de caixa de diálogo comuns, CCHookProc, CHOOSECOLOR, CommDlgExtendedError

Index