Classe CMFCRibbonColorButton

Artigo
08/25/2010

The CMFCRibbonColorButton classe implementa um botão de cor que você pode adicionar a uma BAR de faixa de opções. O botão de cor da faixa de opções exibe um menu suspenso que contém um ou mais paletas de cores.

class CMFCRibbonColorButton : public CMFCRibbonGallery

Membros

Construtores públicos

Nome	Descrição
CMFCRibbonColorButton::CMFCRibbonColorButton

Métodos públicos

Nome	Descrição
CMFCRibbonColorButton::AddColorsGroup	Adiciona um agrupar de cores para a área de cor normal.
CMFCRibbonColorButton::EnableAutomaticButton	Especifica se o Automático botão é ativado.
CMFCRibbonColorButton::EnableOtherButton	Permite que o Outros botão.
CMFCRibbonColorButton::GetAutomaticColor
CMFCRibbonColorButton::GetColor	Retorna a cor selecionada atualmente.
CMFCRibbonColorButton::GetColorBoxSize	Retorna o dimensionar dos elementos de cores que aparecem na BAR de cores.
CMFCRibbonColorButton::GetColumns
CMFCRibbonColorButton::GetHighlightedColor	Retorna a cor do elemento atualmente selecionado na paleta de cores pop-up.
CMFCRibbonColorButton::RemoveAllColorGroups	Remove todos os grupos de cores da área de cor normal.
CMFCRibbonColorButton::SetColor	Seleciona uma cor da área de cor normal.
CMFCRibbonColorButton::SetColorBoxSize	Define o dimensionar de todos os elementos de cores que aparecem na BAR de cores.
CMFCRibbonColorButton::SetColorName
CMFCRibbonColorButton::SetColumns
CMFCRibbonColorButton::SetDocumentColors	Especifica uma lista de valores RGB para exibir na área de cor do documento.
CMFCRibbonColorButton::SetPalette
CMFCRibbonColorButton::UpdateColor

Comentários

Botão cor de faixa de opções exibe uma BAR de cor quando um usuário pressiona-lo.Por padrão, essa BAR de cores contém uma paleta de seleção de cores chamada área de cor normal.Opcionalmente, a BAR de cores pode exibir um Automático botão, que permite ao usuário selecionar uma cor padrão e um Outros botão, que exibe uma paleta de cores pop-up que contém cores adicionais.

Exemplo

O exemplo a seguir demonstra como usar diversos métodos no CMFCRibbonColorButton classe. O exemplo mostra como construir um CMFCRibbonColorButton objeto, conjunto a imagem grande e habilitar o Automático botão, ative o Outros botão, defina o número de colunas, defina o dimensionar de todos os elementos de cor que apareça na BAR de cores, adicionar um agrupar de cores para a área de cor normal e especificar uma lista de valores RGB para exibir na área de cor do documento.Neste trecho de código faz parte o Exemplo do DrawClient: Aplicativos de desenho de objeto OLE com a faixa de opções do MFC.

  // Create the "Paper Color" button
    CMFCRibbonColorButton* pBtnPaperColor = new CMFCRibbonColorButton(ID_VIEW_PAPERCOLOR, _T("Paper Color\ng"), TRUE, 13, 1);
    pBtnPaperColor->SetAlwaysLargeImage();
    pBtnPaperColor->EnableAutomaticButton(_T("&Automatic"), RGB(255, 255, 255));
    pBtnPaperColor->EnableOtherButton(_T("&More Colors..."), _T("More Colors"));
    pBtnPaperColor->SetColumns(10);
    pBtnPaperColor->SetColorBoxSize(CSize(17, 17));
    // CList<COLORREF,COLORREF> m_lstMainColors
    pBtnPaperColor->AddColorsGroup(_T("Theme Colors"), m_lstMainColors, TRUE);
    // CList<COLORREF,COLORREF> m_lstAdditionalColors
    pBtnPaperColor->AddColorsGroup(_T(""), m_lstAdditionalColors, FALSE);
    // CList<COLORREF,COLORREF> m_lstStandardColors
    pBtnPaperColor->AddColorsGroup(_T("Standard Colors"), m_lstStandardColors, TRUE);
    CList<COLORREF,COLORREF> lstColors;
    lstColors.AddTail(RGB(255,0,0));
    lstColors.AddTail(RGB(0,255,0));
    lstColors.AddTail(RGB(0,0,255));
    pBtnPaperColor->SetDocumentColors( _T("Document Colors"), lstColors );