ChooseColor (function)
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
Essa função cria um caixa de diálogo comum de cores que permite que o usuário para selecionar uma cor.
Syntax
BOOL ChooseColor(
LPCHOOSECOLOR lpcc
);
Parameters
- lpcc
Ponteiro longo para um CHOOSECOLOR (estrutura) que contém informações usadas para inicializar a caixa diálogo. Quando ChooseColor Retorna, essa estrutura contém informações sobre seleção cor do usuário.
Return Value
Se o usuário clica a OK botão de caixa de diálogo, o valor de retorno é diferente de zero. O rgbResult membro das CHOOSECOLOR estrutura contém o valor cor RGB da cor selecionada pelo usuário.
Se o usuário cancela ou fecha o Cor caixa diálogo ou um erro ocorre, o valor de retorno é zero. Para informações de erro estendidas get, chamar o CommDlgExtendedError função, que pode retornar uma do seguinte valores:
CDERR_FINDRESFAILURE |
CDERR_MEMALLOCFAILURE |
CDERR_INITIALIZATION |
CDERR_NOHINSTANCE |
CDERR_LOCKRESFAILURE |
CDERR_NOHOOK |
CDERR_LOADRESFAILURE |
CDERR_NOTEMPLATE |
CDERR_LOADSTRFAILURE |
CDERR_STRUCTSIZE |
Remarks
O Cor comum diálogo irá ignorar o sinalizador CC_FULLOPEN se Tela dispositivo de destino é menor que 480 pixels de largura. Neste maiúsculas e minúsculas, o usuário deve clique a Definir cores personalizadas botão para exibir um diálogo segundo com o personalizado controles cor.
Observação
Nas versões anteriores de Windows Embedded CE, a Cor comum diálogo foi cores definidas pelo usuário suporte não se Tela dispositivo de destino for menor que 480 pixels de largura.Neste maiúsculas e minúsculas, os sinalizadores CC_FULLOPEN e CC_PREVENTFULLOPEN foram ignorados.
O Cor caixa diálogo não suporte paletas. As opções cor oferecidas pelo caixa de diálogo são limitadas a cores de sistema e pontilhada versões essas cores.
Você pode fornecer um CCHookProc procedimento gancho para um Cor caixa diálogo. Procedimento de gancho pode processo mensagens enviadas para caixa de diálogo. Para habilitar um procedimento gancho, definir o sinalizador CC_ENABLEHOOK na Sinalizadores membro das CHOOSECOLOR estrutura e especificar o endereço do procedimento de gancho in a lpfnHook membro.
Requirements
| Header | commdlg.h |
| Library | commdlg.lib |
| Windows Embedded CE | Windows CE 2.0 and later |