Classe CMFCColorDialog

A CMFCColorDialog classe representa uma caixa de diálogo de seleção de cores.

Sintaxe

class CMFCColorDialog : public CDialogEx

Membros

Construtores públicos

Name Descrição
CMFCColorDialog::CMFCColorDialog Constrói um objeto CMFCColorDialog.
CMFCColorDialog::~CMFCColorDialog Destruidor.

Métodos públicos

Name Descrição
CMFCColorDialog:: GetColor Retorna a cor selecionada atual.
CMFCColorDialog:: GetPalette Retorna a paleta da cor.
CMFCColorDialog::PreTranslateMessage traduz mensagens de janela antes que elas sejam expedidas para as funções de Windows TranslateMessage e DispatchMessage . Para obter a sintaxe e obter mais informações, consulte CWnd::P retranslatemessage. (Substitui CDialogEx::PreTranslateMessage.)
CMFCColorDialog::RebuildPalette Deriva uma paleta da paleta do sistema.
CMFCColorDialog::SetCurrentColor Define a cor selecionada atualmente.
CMFCColorDialog::SetNewColor Define a cor que é mais equivalente a um valor RGB especificado.
CMFCColorDialog::SetPageOne Seleciona um valor RGB para a primeira página de propriedades.
CMFCColorDialog::SetPageTwo Seleciona um valor RGB para a segunda página de propriedades.

Membros de Dados Protegidos

Name Descrição
m_bIsMyPalette TRUE se a caixa de diálogo de seleção de cor usar sua própria paleta de cores ou FALSE se a caixa de diálogo usar uma paleta especificada no CMFCColorDialog Construtor.
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 permanentemente selecionada ou revertida para a cor original.
m_pColourSheetOne Um ponteiro para a primeira página de propriedades da folha de propriedades de seleção de cores.
m_pColourSheetTwo Um ponteiro para a segunda página de propriedades 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 do seletor de cores.
m_wndStaticPlaceHolder Um controle estático que é um espaço reservado para a folha de propriedades do seletor de cores.

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 página, você seleciona uma cor personalizada.

Você pode construir um CMFCColorDialog objeto na pilha e, em seguida, chamar DoModal , passando a cor inicial como um parâmetro para o CMFCColorDialog Construtor. A caixa de diálogo seleção de cor cria vários objetos de Classe CMFCColorPickerCtrl para lidar com 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 cor usando vários métodos na CMFCColorDialog classe. O exemplo mostra como definir as cores atual 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 cor. Este exemplo faz parte do exemplo 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
no 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
no Um ponteiro para a janela pai ou proprietário da caixa de diálogo.

hPal
no Um identificador para uma paleta de cores.

Valor Retornado

Comentários

CMFCColorDialog:: GetColor

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

COLORREF GetColor() const;

Valor Retornado

Um valor de COLORREF que contém as informações RGB para a cor selecionada na caixa de diálogo cor.

Comentários

Chame essa função depois de chamar o DoModal método.

CMFCColorDialog:: GetPalette

Recupera a paleta de cores que está disponível na caixa de diálogo cor atual.

CPalette* GetPalette() const;

Valor Retornado

Um ponteiro para o CPalette objeto que foi especificado no CMFCColorDialog Construtor.

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
no Um valor de cor RGB

Comentários

CMFCColorDialog::SetNewColor

Define a cor atual para 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 propriedades de uma caixa de diálogo de cor.

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 propriedades de uma caixa de diálogo de cor.

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 de hierarquia
Classes
Classe CMFCColorPickerCtrl