CMFCRibbonColorButton-Klasse

Artikel
06/10/2015

Die CMFCRibbonColorButton-Klasse implementiert eine Farbenschaltfläche, die Sie einer Menübandleiste hinzufügen können. Die Menübandfarbenschaltfläche zeigt ein Dropdownmenü an, das eine oder mehrere Farbpaletten enthält.

class CMFCRibbonColorButton : public CMFCRibbonGallery

Mitglieder

Öffentliche Konstruktoren

Name	Description
CMFCRibbonColorButton::CMFCRibbonColorButton

Öffentliche Methoden

Name	Description
CMFCRibbonColorButton::AddColorsGroup	Fügt eine Gruppe Farben dem regulären Farbenbereich hinzu.
CMFCRibbonColorButton::EnableAutomaticButton	Gibt an, ob die Schaltfläche Automatisch aktiviert ist.
CMFCRibbonColorButton::EnableOtherButton	Aktiviert die Schaltfläche Andere.
CMFCRibbonColorButton::GetAutomaticColor
CMFCRibbonColorButton::GetColor	Gibt die aktuell ausgewählte Farbe zurück.
CMFCRibbonColorButton::GetColorBoxSize	Gibt die Größe der Farbenelemente zurück, die auf der Farbleiste angezeigt werden.
CMFCRibbonColorButton::GetColumns
CMFCRibbonColorButton::GetHighlightedColor	Gibt die Farbe des aktuell ausgewählten Elements auf der Farbpalette von Popups zurück.
CMFCRibbonColorButton::RemoveAllColorGroups	Entfernt alle Farbengruppen des regulären Farbenbereich.
CMFCRibbonColorButton::SetColor	Wählt eine Farbe im regulären Farbenbereich aus.
CMFCRibbonColorButton::SetColorBoxSize	Legt die Größe aller Farbenelemente fest, die auf der Farbleiste angezeigt werden.
CMFCRibbonColorButton::SetColorName
CMFCRibbonColorButton::SetColumns
CMFCRibbonColorButton::SetDocumentColors	Gibt eine Liste von RGB-Werten an, die im Dokumentenfarbenbereich anzuzeigen.
CMFCRibbonColorButton::SetPalette
CMFCRibbonColorButton::UpdateColor

Hinweise

Die Menübandfarbenschaltfläche zeigt eine Farbleiste an, wenn sie von einem Benutzer drückt. Standardmäßig enthält diese Farbleiste einer aufgerufenen Farben-Auswahlpalette der reguläre Farbenbereich. Optional kann die Farbleiste Automatisch eine Schaltfläche, die dem Benutzer, die ermöglicht eine Standardfarbe auszuwählen, und eine Schaltfläche Andere anzeigen, die eine Popup- Farbpalette anzeigt, die zusätzliche Farben enthält.

Beispiel

Das folgende Beispiel zeigt, wie verschiedene Methoden in der Klasse CMFCRibbonColorButton verwendet. Im Beispiel wird gezeigt, wie ein CMFCRibbonColorButton-Objekt, legen Sie das umfangreiche Bild, ermöglichen die Schaltfläche Automatisch aktivieren, die Schaltfläche Andere, legen Sie die Spaltenanzahl, legen Sie die Größe aller Farbenelemente erstellt, die auf der Farbleiste angezeigt werden, eine Gruppe Farben dem regulären Farbenbereich hinzufügen und eine Liste von RGB-Werten angeben, die im Dokumentenfarbenbereich anzuzeigen. Dieser Codeausschnitt ist Teil Clientbeispiel Videofunktionen.

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