CHOOSECOLOR

A estrutura CHOOSECOLOR contém informações de que CHOOSECOLOR função usa para inicializar o cor caixa de diálogo comum. Depois que o usuário fecha a caixa de diálogo, o sistema retorna informações sobre a seleção do usuário nessa estrutura.

typedef struct {/ / cc DWORD lStructSize; 
    HWND hwndOwner; 
    HWND hInstance; 
    COLORREF rgbResult; 
    COLORREF * lpCustColors; 
    DWORD Sinalizadores; 
    LPARAM lCustData; 
    LPCCHOOKPROC lpfnHook; 
    LPCTSTR lpTemplateName; 
} CHOOSECOLOR 

 

Membros

lStructSize

Especifica o comprimento, em bytes, da estrutura.

hwndOwner

Identifica a janela que possui a caixa de diálogo. Esse membro pode ser qualquer válido identificador janela, ou ele pode ser NULL se a caixa de diálogo não possui nenhum proprietário.

hInstance

Se o sinalizador CC_ENABLETEMPLATEHANDLE é definido na sinalizadores membro, hInstance é o identificador de um objeto de memória que contém um modelo caixa diálogo. Se o sinalizador CC_ENABLETEMPLATE é definido, hInstance identifica um módulo que contém um modelo de caixa de diálogo nomeado pela lpTemplateName membro. Se nem CC_ENABLETEMPLATEHANDLE CC_ENABLETEMPLATE é definido, esse membro será ignorado.

rgbResult

Se o sinalizador CC_RGBINIT for definido, rgbResult especifica a cor selecionada inicialmente quando a caixa diálogo é criada. Se o valor de cor especificado não está entre as cores disponíveis, o sistema seleciona a cor sólida mais próxima disponível. Se rgbResult é zero ou CC_RGBINIT não é definida, a cor selecionada inicialmente é preta. Se o usuário clica a OK botão, rgbResult Especifica seleção de cor do usuário.

lpCustColors

Ponteiro para uma matriz de 16 COLORREF valores que contêm vermelhos, verdes, azuis (RGB) valores cor Personalizar caixas de caixa de diálogo. Se o usuário modifica essas cores, o sistema atualiza a matriz com os novos valores RGB. Para preservar o novos cores personalizadas entre as chamadas para a função ChooseColor , você deve alocar memória estática para a matriz.

Sinalizadores

Um conjunto de bit sinalizadores que você pode usar para inicializar o cor caixa de diálogo comum. Quando a caixa de diálogo retorna, ele define esses sinalizadores para indicar a entrada do usuário. Esse membro pode ser uma combinação dos sinalizadores a seguir:

Bandeira	Significado
CC_ANYCOLOR	Faz com que a caixa de diálogo Exibir todas as cores disponíveis no conjunto de basic cores.
CC_ENABLEHOOK	Permite que o procedimento gancho especificado na lpfnHook membro dessa estrutura. Este sinalizador é usado somente para inicializar a caixa de diálogo.
CC_ENABLETEMPLATE	Indica que o hInstance e lpTemplateName Membros especificar um modelo de caixa de diálogo para usar no lugar do modelo padrão. Este sinalizador é usado somente para inicializar a caixa de diálogo.
CC_ENABLETEMPLATEHANDLE	Indica que o hInstance membro identifica um bloco dados que contém um modelo caixa diálogo pré-carregadas. O sistema ignora o lpTemplateName membro se este sinalizador for especificado. Este sinalizador é usado somente para inicializar a caixa de diálogo.
CC_FULLOPEN	Faz com que a caixa de diálogo exibir os controles adicionais que permitem que o usuário criar cores personalizadas. Se este sinalizador não estiver definido, o usuário deve clicar em Definir personalizado cor botão para exibir os controles de cor personalizada.
CC_PREVENTFULLOPEN	Desabilita o botão decores Personalizar Definir .
CC_RGBINIT	Faz com que a caixa de diálogo usar a cor especificada na rgbResult membro como a seleção de cor inicial.
CC_SHOWHELP	Faz com que a caixa de diálogo exibir o botão de ajuda. O hwndOwner membro deve especificar a janela para receber a HELPMSGSTRING registadas mensagens de caixa de diálogo envia quando o usuário clica no botão Ajuda.
CC_SOLIDCOLOR	Faz com que a caixa de diálogo exibir somente cores sólidas no conjunto de basic cores.

lCustData

Especifica dados application-defined que o sistema passa para o procedimento gancho identificado pelo lpfnHook membro. Quando o sistema envia o WM_INITDIALOG mensagem para o procedimento gancho, lParam parâmetro a mensagem é que um ponteiro para o CHOOSECOLOR estrutura especificado quando o diálogo foi criado. O procedimento de gancho pode usar esse ponteiro para obter o valor de lCustData.

lpfnHook

Ponteiro para um CCHookProc procedimento gancho que pode mensagens processo destinadas a caixa de diálogo. Esse membro é ignorado a menos que o sinalizador CC_ENABLEHOOK é definido na sinalizadores membro.

lpTemplateName

Ponteiro para uma seqüência de caracteres null-terminated que nomeia o recurso de modelo caixa diálogo no módulo identificado pelo hInstance membro. Este modelo é substituído para o padrão modelo caixa diálogo. Para recursos de caixa de diálogo numerada, lpTemplateName pode ser um valor retornado pela MAKEINTRESOURCE macro. Esse membro é ignorado a menos que o sinalizador CC_ENABLETEMPLATE é definido na sinalizadores membro.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declaradas no commdlg.h.
Unicode:Definidos como estruturas ANSI e Unicode.

Ver também

Visão geral de biblioteca de caixa de diálogo comum, estruturas de caixa de diálogo comuns, CCHookProc, ChooseColor, MAKEINTRESOURCE, WM_INITDIALOG