Classe CMFCColorDialog
A classe CMFCColorDialog representa uma caixa de diálogo de seleção de cores.
Sintaxe
class CMFCColorDialog : public CDialogEx
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| CMFCColorDialog::CMFCColorDialog | Constrói um objeto CMFCColorDialog. |
CMFCColorDialog::~CMFCColorDialog |
Destruidor. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CMFCColorDialog::GetColor | Retorna a cor selecionada atual. |
| CMFCColorDialog::GetPalette | Retorna a paleta da cor. |
CMFCColorDialog::PreTranslateMessage |
Converte mensagens de janela antes de serem enviadas para as funções TranslateMessage e DispatchMessage de Windows. Para conhecer a sintaxe e obter mais informações, consulte CWnd::PreTranslateMessage. (Substitui CDialogEx::PreTranslateMessage.) |
| CMFCColorDialog::RebuildPalette | Deriva uma paleta da paleta do sistema. |
| CMFCColorDialog::SetCurrentColor | Define a cor selecionada atual. |
| CMFCColorDialog::SetNewColor | Define a cor mais equivalente a um valor RGB especificado. |
| CMFCColorDialog::SetPageOne | Seleciona um valor RGB para a primeira página de propriedade. |
| CMFCColorDialog::SetPageTwo | Seleciona um valor RGB para a segunda página de propriedade. |
Membros de dados protegidos
| Nome | Descrição |
|---|---|
m_bIsMyPalette |
TRUE se a caixa de diálogo de seleção de cores usar a própria paleta de cores ou FALSE se usar uma paleta especificada no construtor CMFCColorDialog. |
m_bPickerMode |
TRUE enquanto o usuário está selecionando uma cor na caixa de diálogo de seleção; caso contrário, FALSE. |
m_btnColorSelect |
O botão de cor que o usuário selecionou. |
m_CurrentColor |
A cor selecionada no momento. |
m_hcurPicker |
O cursor usado para escolher uma cor. |
m_NewColor |
A cor selecionada em potencial, que pode ser selecionada permanentemente ou revertida para a cor original. |
m_pColourSheetOne |
Um ponteiro para a primeira página de propriedade da folha de propriedades de seleção de cores. |
m_pColourSheetTwo |
Um ponteiro para a segunda página de propriedade da folha de propriedades de seleção de cores. |
m_pPalette |
A paleta lógica atual. |
m_pPropSheet |
Um ponteiro para a folha de propriedades da caixa de diálogo de seleção de cores. |
m_wndColors |
Um objeto de controle de seletor de cor. |
m_wndStaticPlaceHolder |
Um controle estático que é um espaço reservado para a folha de propriedades do seletor de cor. |
Comentários
A caixa de diálogo seleção de cor é exibida como uma folha de propriedades com duas páginas. Na primeira página, você seleciona uma cor padrão na paleta do sistema; na segunda, seleciona uma cor personalizada.
Você pode construir um objeto CMFCColorDialog na pilha e, em seguida, chamar DoModal, passando a cor inicial como um parâmetro para o construtor CMFCColorDialog. A caixa de diálogo seleção de cor cria vários objetos da classe CMFCColorPickerCtrl para manipular cada paleta de cores.
Hierarquia de herança
Exemplo
O exemplo a seguir demonstra como configurar uma caixa de diálogo de cores usando vários métodos na classe CMFCColorDialog. O exemplo mostra como definir as cores atuais e novas da caixa de diálogo e como definir os componentes vermelho, verde e azul de uma cor selecionada nas duas páginas de propriedades da caixa de diálogo de cores. Este exemplo faz parte da amostra de Novos Controles.
// COLORREF m_Color
CMFCColorDialog dlg(m_Color, 0, this);
dlg.SetCurrentColor(RGB(0, 255, 0));
dlg.SetNewColor(RGB(0, 0, 255));
// set the red, green, and blue components of a selected
// color on the two property pages of the color dialog
dlg.SetPageOne(255, 0, 0);
dlg.SetPageTwo(0, 255, 0);
Requisitos
Cabeçalho: afxcolordialog.h
CMFCColorDialog::CMFCColorDialog
Constrói um objeto CMFCColorDialog.
CMFCColorDialog(
COLORREF clrInit=0,
DWORD dwFlags=0,
CWnd* pParentWnd=NULL,
HPALETTE hPal=NULL);
Parâmetros
clrInit
[in] A seleção de cor padrão. Se nenhum valor for especificado, o padrão será RGB(0,0,0) (preto).
dwFlags
[in] Reservado.
pParentWnd
[in] Um ponteiro para a janela pai ou proprietária da caixa de diálogo.
hPal
[in] Um identificador para uma paleta de cores.
Valor de retorno
Comentários
CMFCColorDialog::GetColor
Recupera a cor que o usuário seleciona na caixa de diálogo de cores.
COLORREF GetColor() const;
Valor de retorno
Um valor COLORREF que contém as informações RGB para a cor selecionada na caixa de diálogo de cores.
Comentários
Chame essa função depois de chamar o método DoModal.
CMFCColorDialog::GetPalette
Recupera a paleta de cores disponível na caixa de diálogo de cores atual.
CPalette* GetPalette() const;
Valor de retorno
Um ponteiro para o objeto CPalette especificado no construtor CMFCColorDialog.
Comentários
A paleta de cores especifica as cores que o usuário pode escolher.
CMFCColorDialog::RebuildPalette
Deriva uma paleta da paleta do sistema.
void RebuildPalette();
CMFCColorDialog::SetCurrentColor
Define a cor atual da caixa de diálogo.
void SetCurrentColor(COLORREF rgb);
Parâmetros
rgb
[in] Um valor de cor RGB
Comentários
CMFCColorDialog::SetNewColor
Define a cor atual como a cor na paleta atual que é mais semelhante.
void SetNewColor(COLORREF rgb);
Parâmetros
rgb
[in] Um COLORREF que especifica uma cor RGB.
Comentários
CMFCColorDialog::SetPageOne
Especifica explicitamente os componentes vermelho, verde e azul de uma cor selecionada na primeira página de propriedade de uma caixa de diálogo de cores.
void SetPageOne(
BYTE R,
BYTE G,
BYTE B);
Parâmetros
R
[in] Especifica o componente vermelho do valor RGB.
G
[in] Especifica o componente verde do valor RGB.
B
[in] Especifica o componente azul do valor RGB.
Comentários
CMFCColorDialog::SetPageTwo
Especifica explicitamente os componentes vermelho, verde e azul de uma cor selecionada na segunda página de propriedade de uma caixa de diálogo de cores.
void SetPageTwo(
BYTE R,
BYTE G,
BYTE B);
Parâmetros
R
[in] Especifica um componente vermelho do valor RGB
G
[in] Especifica um componente verde de um valor RGB
B
[in] Especifica um componente azul de um valor RGB