Classe CMFCRibbonColorButton

Articolo
06/10/2015

La classe CMFCRibbonColorButton implementa un pulsante di colori che è possibile aggiungere a una barra multifunzione. Il pulsante di colore della barra multifunzione viene visualizzato un menu a discesa contenente uno o più tavolozze dei colori.

class CMFCRibbonColorButton : public CMFCRibbonGallery

Membri

Costruttori pubblici

Nome	Descrizione
CMFCRibbonColorButton::CMFCRibbonColorButton

Metodi pubblici

Nome	Descrizione
CMFCRibbonColorButton::AddColorsGroup	Aggiunge un gruppo di colori all'area normale di colore.
CMFCRibbonColorButton::EnableAutomaticButton	Specifica se il pulsante Automatico è abilitato.
CMFCRibbonColorButton::EnableOtherButton	Abilita il pulsante Altri.
CMFCRibbonColorButton::GetAutomaticColor
CMFCRibbonColorButton::GetColor	Restituisce il colore selezionato.
CMFCRibbonColorButton::GetColorBoxSize	Restituisce le dimensioni degli elementi di colori visualizzati nella barra dei colori.
CMFCRibbonColorButton::GetColumns
CMFCRibbonColorButton::GetHighlightedColor	Restituisce il colore dell'elemento attualmente selezionato nella tavolozza di colori popup.
CMFCRibbonColorButton::RemoveAllColorGroups	Rimuove tutti i gruppi di colore dall'area normale di colore.
CMFCRibbonColorButton::SetColor	Selezionare un colore dall'area normale di colore.
CMFCRibbonColorButton::SetColorBoxSize	Imposta la dimensione di tutti gli elementi di colori visualizzati nella barra dei colori.
CMFCRibbonColorButton::SetColorName
CMFCRibbonColorButton::SetColumns
CMFCRibbonColorButton::SetDocumentColors	Specifica un elenco di valori RGB da visualizzare nell'area di colore documento.
CMFCRibbonColorButton::SetPalette
CMFCRibbonColorButton::UpdateColor

Note

Il pulsante di colore della barra multifunzione viene visualizzata una barra di colore quando un utente preme lo. Per impostazione predefinita, questa barra dei colori contiene una tavolozza di selezione di colori chiamata l'area normale di colore. Facoltativamente, la barra dei colori può visualizzare un pulsante Automatico, che consente di selezionare un colore predefinito e un pulsante Altri, che visualizza una tavolozza di colori popup contenente i colori aggiuntivi.

Esempio

Nell'esempio seguente viene illustrato come utilizzare i vari metodi della classe CMFCRibbonColorButton. L'esempio mostra come costruire un oggetto CMFCRibbonColorButton, impostare la immagine grande, abilitare il pulsante Automatico, abilitare il pulsante Altri, impostare il numero di colonne, impostare le dimensioni di tutti gli elementi di colori visualizzati nella barra dei colori, aggiungere un gruppo di colori all'area normale di colore e specificano un elenco di valori RGB da visualizzare nell'area di colore documento. Questo frammento di codice fa parte Esempio client di disegno.

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