CHOOSECOLOR (structure)

9/9/2008

Essa estrutura contém informações de ChooseColor função usa para inicializar o Cor caixa de diálogo comum. Depois que um usuário fecha a caixa diálogo, o sistema usa essa estrutura para retornar informações sobre seleção do usuário.

Syntax

typedef struct tagCHOOSECOLOR {
  DWORD lStructSize;
  HWND hwndOwner;
  HINSTANCE hInstance;
  COLORREF rgbResult;
  COLORREF* lpCustColors;
  DWORD Flags;
  LPARAM lCustData;
  LPCCHOOKPROC lpfnHook;
  LPCTSTR lpTemplateName;
} CHOOSECOLOR, *LPCHOOSECOLOR;

Os membros

• lStructSize
  Especifica o comprimento, em bytes, da estrutura.

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

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

• rgbResult
  Se o sinalizador CC_RGBINIT for definida, esse membro especifica a cor selecionada inicialmente quando a caixa diálogo é criada. Se o valor cor especificado não está entre o disponível cores, o sistema seleciona o mais próximo disponível cor sólida. 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 cor do usuário.

• lpCustColors
  Ponteiro longo para uma matriz de 16 COLORREF Valores que contêm vermelho, verde, azul (RGB) valores para o personalizado caixas cor na caixa de diálogo. Se o usuário modifica essas cores, o sistema atualiza a matriz com os novos valores RGB. Para preservar personalizado novo cores entre chamadas para ChooseColor (função), você deve alocar memória estática para a matriz.

• Sinalizadores
  Conjunto de sinalizadores bit usado para inicializar o Cor caixa de diálogo comum. Quando a caixa diálogo retorna, ele define esses sinalizadores para indicar entrada do usuário. Esse membro pode ser uma combinação do seguinte sinalizadores.

  Valor	Descrição
  CC_ANYCOLOR	Faz com que a caixa diálogo para exibir disponível todas as cores do conjunto de cores básicas.
  CC_ENABLEHOOK	Permite que o procedimento gancho especificado na lpfnHook membro dessa estrutura. Este sinalizador é usado somente para inicializar a caixa diálogo.
  CC_ENABLETEMPLATE	Indica que o hInstance e lpTemplateName Membros especificar um modelo caixa diálogo para usar no local do modelo de usar como padrão. Este sinalizador é usado somente para inicializar a caixa 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 a lpTemplateName membro Se este sinalizador é especificado. Este sinalizador é usado somente para inicializar a caixa diálogo.
  CC_FULLOPEN	Faz com que a caixa diálogo para exibir os controles adicionais que permitem que o usuário para criar personalizado cores. Se este sinalizador não estiver definido, o usuário deve clique a Definir Personalizado Cor botão para exibir o personalizado controles cor.
  CC_PREVENTFULLOPEN	Desativa o Definir Personalizado Cores botão.
  CC_RGBINIT	Faz com que a caixa diálogo para usar a cor especificada na rgbResult membro como a seleção cor inicial.
  CC_SOLIDCOLOR	Faz com que a caixa diálogo para exibir somente sólida cores no conjunto de cores básicas.

• 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 do o gancho procedimento, a mensagem lParam parâmetro é um ponteiro para o CHOOSECOLOR estrutura especificado quando o diálogo foi criado. Procedimento de gancho pode usar esse ponteiro para get a lCustData valor.

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

• lpTemplateName
  Ponteiro longo para um seqüência de caracteres NULL-Terminated que nomes de recurso modelo caixa diálogo no módulo identificado pelo hInstance membro. Este modelo é substituído para o padrão modelo caixa diálogo. Para obter recursos caixa 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.

Requirements

Header	commdlg.h
Windows Embedded CE	Windows CE 2.0 and later

See Also

Reference

CCHookProc
ChooseColor (function)
COLORREF
MAKEINTRESOURCE
WM_INITDIALOG