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

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

CMFCColorDialog

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 Devolução

Comentários

CMFCColorDialog::GetColor

Recupera a cor que o usuário seleciona na caixa de diálogo de cores.

COLORREF GetColor() const;

Valor de Devolução

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 Devolução

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

Comentários

Confira também

Gráfico da hierarquia
Classes
Classe CMFCColorPickerCtrl