CMFCColorPopupMenu::CMFCColorPopupMenu

Constructs a CMFCColorPopupMenu object.

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

Parameters

  • [in] colors
    An array of colors that the framework displays on the pop-up menu.

  • [in] color
    The default selected color.

  • [in] lpszAutoColor
    The text label of the automatic (default) color button, or NULL.

    The standard label for the automatic button is Automatic.

  • [in] lpszOtherColor
    The text label of the other button, which displays more color choices, or NULL.

    The standard label for the other button is More Colors....

  • [in] lpszDocColors
    The text label of the document colors button. The document colors palette lists all the colors that the document currently uses.

  • [in] lstDocColors
    A list of colors that the document currently uses.

  • [in] nColumns
    The number of columns that the array of colors has.

  • [in] nHorzDockRows
    The number of rows that the color bar has when it is docked horizontally.

  • [in] nVertDockColumns
    The number of columns that the color bar has when it is docked vertically.

  • [in] colorAutomatic
    The default color that the framework applies when you click the automatic button.

  • [in] uiCommandID
    The color bar control command ID.

  • [in] bStdColorDlg
    A Boolean that indicates whether to show the standard system color dialog box or the CMFCColorDialog dialog box.

  • [in] pParentBtn
    A pointer to a parent button.

  • [in] nID
    The command ID.

Remarks

Each overloaded constructor sets the m_bEnabledInCustomizeMode member to FALSE.

Example

The following example demonstrates how to construct a CMFCColorPopupMenu object.

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

Requirements

Header: afxcolorpopupmenu.h

See Also

Concepts

MFC Hierarchy Chart

Reference

CMFCColorPopupMenu Class