Classe CMFCRibbonColorButton

Artigo
06/10/2015

A classe de CMFCRibbonColorButton implementa um botão de cor que você pode adicionar a barra de fita. O botão de cor de fita exibe um menu drop-down que contém uma ou mais paletas de cores.

class CMFCRibbonColorButton : public CMFCRibbonGallery

Membros

Construtores public

Nome	Descrição
CMFCRibbonColorButton::CMFCRibbonColorButton

Métodos públicos

Nome	Descrição
CMFCRibbonColorButton::AddColorsGroup	Adiciona um grupo de cores para a área de cor normal.
CMFCRibbonColorButton::EnableAutomaticButton	Especifica se o botão de Automático está habilitado.
CMFCRibbonColorButton::EnableOtherButton	Habilita o botão de Outro .
CMFCRibbonColorButton::GetAutomaticColor
CMFCRibbonColorButton::GetColor	Retorna a cor selecionada.
CMFCRibbonColorButton::GetColorBoxSize	Retorna o tamanho dos elementos de cor que aparecem na barra de cor.
CMFCRibbonColorButton::GetColumns
CMFCRibbonColorButton::GetHighlightedColor	Retorna a cor do elemento selecionado em paleta de cores pop-up.
CMFCRibbonColorButton::RemoveAllColorGroups	Remove todos os grupos de cor da área normal de cor.
CMFCRibbonColorButton::SetColor	Selecione uma cor da área normal de cor.
CMFCRibbonColorButton::SetColorBoxSize	Defina o tamanho de todos os elementos de cor que aparecem na barra de cor.
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

O botão de cor de fita exibe uma barra de cor quando um usuário pressiona o. Por padrão, essa barra de cor contém uma paleta de seleção de cores chamada a área normal de cor. Opcionalmente, a barra de cor pode exibir um botão de Automático , que permite que o usuário selecione uma cor padrão, e um botão de Outro , que exibe uma paleta de cores pop-up que contém cores adicionais.

Exemplo

O exemplo a seguir demonstra como usar vários métodos na classe de CMFCRibbonColorButton . O exemplo a seguir mostra como criar um objeto de CMFCRibbonColorButton , defina a grande imagem, habilita o botão de Automático , habilita o botão de Outro , define o número de colunas, defina o tamanho de todos os elementos de cor que aparecem na barra de cor, adicione um grupo de cores para a área de cor normal, e especificam uma lista de valores RGB para exibir na área de cor do documento. Este trecho de código é parte de Exemplo do cliente de desenho.

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