Partilhar via

Classe CMFCColorDialog

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

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

Sintaxe

class CMFCColorDialog : public CDialogEx

Membros

Construtores Públicos

Nome Description
CMFCColorDialog::CMFCColorDialog Constrói um CMFCColorDialog objeto.
CMFCColorDialog::~CMFCColorDialog Destruidor.

Métodos Públicos

Nome Description
CMFCColorDialog::GetColor Devolve a cor selecionada atualmente.
CMFCColorDialog::GetPalette Devolve a paleta de cores.
CMFCColorDialog::PreTranslateMessage Traduz mensagens de janela antes de serem enviadas para as funções de Janelas TranslateMessage e DispatchMessage . Para sintaxe e mais informações, veja CWnd::P reTranslateMessage. (Anula CDialogEx::PreTranslateMessage.)
CMFCColorDialog::RebuildPalette Deriva uma paleta a partir da paleta do sistema.
CMFCColorDialog::SetCurrentColor Define a cor selecionada atualmente.
CMFCColorDialog::SetNewColor Define a cor 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

Nome Description
m_bIsMyPalette TRUE se a caixa de diálogo de seleção de cores usar a 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 utilizador está a selecionar uma cor na caixa de diálogo de seleção; caso contrário, FALSO.
m_btnColorSelect O botão de cor que o utilizador selecionou.
m_CurrentColor A cor atualmente selecionada.
m_hcurPicker O cursor usado para escolher uma cor.
m_NewColor A cor escolhida em potencial, que pode ser selecionada permanentemente ou revertida à cor original.
m_pColourSheetOne Um apontador para a primeira página de propriedades da folha de propriedades de seleção de cores.
m_pColourSheetTwo Um apontador 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 cor.
m_wndColors Um objeto de controlo do selector de cores.
m_wndStaticPlaceHolder Um controlo estático que serve de marcador para a folha de propriedades do seletor de cores.

Observações

A caixa de diálogo de seleção de cores é apresentada como uma folha de propriedades com duas páginas. Na primeira página, seleciona uma cor padrão da paleta do sistema; Na segunda página, seleciona uma cor personalizada.

Pode construir um CMFCColorDialog objeto na pilha e depois chamar DoModal, passando a cor inicial como parâmetro ao CMFCColorDialog construtor. A caixa de diálogo de seleção de cores cria então vários objetos CMFCColorPickerCtrl Class para gerir cada paleta de cores.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

CMFCColorDialog

Example

O exemplo seguinte demonstra como configurar um diálogo de cores usando vários métodos na CMFCColorDialog classe. O exemplo mostra como definir as cores atuais e novas do diálogo, e como definir os componentes vermelho, verde e azul de uma cor selecionada nas duas páginas de propriedades do diálogo de cores. Este exemplo faz parte do exemplo New Controls.

// 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);

Requerimentos

Cabeçalho: afxcolordialog.h

CMFCColorDialog::CMFCColorDialog

Constrói um CMFCColorDialog objeto.

CMFCColorDialog(
    COLORREF clrInit=0,
    DWORD dwFlags=0,
    CWnd* pParentWnd=NULL,
    HPALETTE hPal=NULL);

Parâmetros

clrInit
[dentro] A seleção de cores por defeito. Se não for especificado um valor, o padrão é RGB(0,0,0) (preto).

dwBandeiras
[dentro] Reservado.

pParentWnd
[dentro] Um apontador para a janela pai ou proprietária da caixa de diálogo.

hPal
[dentro] Uma pega para uma paleta de cores.

Valor de retorno

Observações

CMFCColorDialog::GetColor

Recupera a cor que o utilizador seleciona no diálogo de cores.

COLORREF GetColor() const;

Valor de retorno

Um valor COLORREF que contém a informação RGB para a cor selecionada na caixa de diálogo de cores.

Observações

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

CMFCColorDialog::GetPalette

Recupera a paleta de cores disponível no diálogo de cores atual.

CPalette* GetPalette() const;

Valor de retorno

Um apontador para o CPalette objeto especificado no CMFCColorDialog construtor.

Observações

A paleta de cores especifica as cores que o utilizador pode escolher.

CMFCColorDialog::RebuildPalette

Deriva uma paleta a partir da paleta do sistema.

void RebuildPalette();

CMFCColorDialog::SetCurrentColor

Define a cor atual da caixa de diálogo.

void SetCurrentColor(COLORREF rgb);

Parâmetros

RGB
[dentro] Um valor de cor RGB

Observações

CMFCColorDialog::SetNewColor

Define a cor atual para a cor da paleta atual que é mais semelhante.

void SetNewColor(COLORREF rgb);

Parâmetros

RGB
[dentro] Um COLORREF que especifica uma cor RGB.

Observações

CMFCColorDialog::SetPageOne

Especifica explicitamente os componentes vermelho, verde e azul de uma cor selecionada na primeira página de propriedades de um diálogo de cor.

void SetPageOne(
    BYTE R,
    BYTE G,
    BYTE B);

Parâmetros

R
[dentro] Especifica o componente vermelho do valor RGB.

G
[dentro] Especifica o componente verde do valor RGB.

B
[dentro] Especifica o componente azul do valor RGB.

Observações

CMFCColorDialog::SetPageTwo

Especifica explicitamente os componentes vermelho, verde e azul de uma cor selecionada na segunda página de propriedades de um diálogo de cor.

void SetPageTwo(
    BYTE R,
    BYTE G,
    BYTE B);

Parâmetros

R
[dentro] Especifica um componente vermelho do valor RGB

G
[dentro] Especifica um componente verde de um valor RGB

B
[dentro] Especifica um componente azul de um valor RGB

Observações

Consulte também

Gráfico de Hierarquia
Classes
CMFCColorPickerCtrl Class

  • Last updated on