CMFCColorPopupMenu-Klasse

Stellt ein Popupmenü dar, das Benutzer zum Auswählen von Farben in einem Dokument oder einer Anwendung verwenden.

Syntax

class CMFCColorPopupMenu : public CMFCPopupMenu

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Datenelemente

Hinweise

Diese Klasse erbt die Popupmenüfunktionalität der CMFCPopupMenu Klasse und verwaltet ein CMFCColorBar Objekt, das farbauswahl bereitstellt. Wenn sich das Symbolleistenframework im Anpassungsmodus befindet und das m_bEnabledInCustomizeMode Element auf FALSE festgelegt ist, wird das Farbleistenobjekt nicht angezeigt. Weitere Informationen zum Anpassungsmodus finden Sie unter CMFCToolBar::IsCustomizeMode

Weitere Informationen CMFCColorBarfinden Sie unter CMFCColorBar Class.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

CMFCPopupMenu

CMFCColorPopupMenu

Anforderungen

Kopfzeile: afxcolorpopupmenu.h

CMFCColorPopupMenu::CMFCColorPopupMenu

Erstellt ein CMFCColorPopupMenu-Objekt.

CMFCColorPopupMenu(
    const CArray<COLORREF, COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors, CList<COLORREF, COLORREF>& lstDocColors,
    int nColumns,
    int nHorzDockRows,
    int nVertDockColumns,
    COLORREF colorAutomatic,
    UINT uiCommandID,
    BOOL bStdColorDlg = FALSE);

CMFCColorPopupMenu(
    CMFCColorButton* pParentBtn,
    const CArray<COLORREF, COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors, CList<COLORREF, COLORREF>& lstDocColors,
    int nColumns,
    COLORREF colorAutomatic);

CMFCColorPopupMenu(
    CMFCRibbonColorButton* pParentBtn,
    const CArray<COLORREF, COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors, CList<COLORREF, COLORREF>& lstDocColors,
    int nColumns,
    COLORREF colorAutomatic,
    UINT nID);

Parameter

Farben
[in] Ein Array von Farben, die das Framework im Popupmenü anzeigt.

color
[in] Die standard ausgewählte Farbe.

lpszAutoColor
[in] Die Textbezeichnung der automatischen (Standard)-Farbschaltfläche oder NULL.

Die Standardbezeichnung für die automatische Schaltfläche ist "Automatisch".

lpszOtherColor
[in] Die Textbezeichnung der anderen Schaltfläche, die weitere Farbauswahlen oder NULL anzeigt.

Die Standardbezeichnung für die andere Schaltfläche ist "Weitere Farben...".

lpszDocColors
[in] Die Textbezeichnung der Schaltfläche "Dokumentfarben". Die Dokumentfarbenpalette listet alle Farben auf, die das Dokument derzeit verwendet.

lstDocColors
[in] Eine Liste der Farben, die das Dokument derzeit verwendet.

nColumns
[in] Die Anzahl der Spalten, über die das Array von Farben verfügt.

nHorzDockRows
[in] Die Anzahl der Zeilen, die der Farbbalken hat, wenn er horizontal angedockt wird.

nVertDockColumns
[in] Die Anzahl der Spalten, die der Farbbalken hat, wenn er vertikal angedockt wird.

colorAutomatic
[in] Die Standardfarbe, die das Framework anwendet, wenn Sie auf die automatische Schaltfläche klicken.

uiCommandID
[in] Befehls-ID des Farbleisten-Steuerelements.

bStdColorDlg
[in] Ein Boolescher Wert, der angibt, ob das Standardmäßige Systemfarbdialogfeld oder das Dialogfeld CMFCColorDialog angezeigt werden soll.

pParentBtn
[in] Ein Zeiger auf eine übergeordnete Schaltfläche.

Nid
[in] Die Befehls-ID.

Hinweise

Jeder überladene Konstruktor legt das m_bEnabledInCustomizeMode Element auf FALSE fest.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie ein CMFCColorPopupMenu Objekt erstellt wird.

COLORREF color;
CArray<COLORREF, COLORREF> colors;
CString strAutoColorText;
CString strOtherText;
CString strDocColorsText;
CList<COLORREF, COLORREF> lstDocColors;
COLORREF colorAutomatic;
int nColumns;
CMFCColorButton colorButton;
CMFCColorPopupMenu *pPopup = new CMFCColorPopupMenu(&colorButton, colors, color, strAutoColorText, strOtherText, strDocColorsText, lstDocColors, nColumns, colorAutomatic);

CMFCColorPopupMenu::CreateTearOffBar

Erstellt einen andockbaren Abrissfarbbalken.

virtual CPane* CreateTearOffBar(
    CFrameWnd* pWndMain,
    UINT uiID,
    LPCTSTR lpszName);

Parameter

pWndMain
[in] Zeigen Sie auf das übergeordnete Fenster der Reißleiste.

uiID
[in] Die Befehls-ID der Reißleiste.

lpszName
[in] Der Fenstertext der Reißleiste.

Rückgabewert

Ein Zeiger auf das neue Reißleistenobjekt.

Hinweise

Diese Methode erstellt ein CMFCColorBar Class-Objekt und wandelt es in einen CPane Class-Zeiger um. Sie können diesen Wert wieder in einen CMFCColorBar-Klassenzeiger umwandeln, indem Sie eines der Umwandlungsmakros verwenden, die unter "Type Casting of MFC Class Objects" beschrieben sind.

CMFCColorPopupMenu::GetMenuBar

Gibt die CMFCPopupMenuBar zurück, die in das Popupmenü eingebettet ist.

virtual CMFCPopupMenuBar* GetMenuBar();

Rückgabewert

Ein Zeiger auf das eingebettete CMFCPopupMenuBarElement.

Hinweise

Das Farbpopupmenü verfügt über ein eingebettetes CMFCPopupMenuBar Class-Objekt . Überschreiben Sie diese Methode in einer abgeleiteten Klasse, wenn Ihre Anwendung einen anderen eingebetteten Typ verwendet.

CMFCColorPopupMenu::SetPropList

Legt das Objekt des Eigenschaftenrastersteuerelements des eingebetteten CMFCColorBar Objekts fest.

void SetPropList(CMFCPropertyGridCtrl* pWndList);

Parameter

pWndList
[in] Zeiger auf ein Eigenschaftsraster-Steuerelementobjekt.

Siehe auch

Hierarchiediagramm
Klassen