CMFCColorPopupMenu 類別

發行項
08/04/2024

代表使用者用來選取檔或應用程式中色彩的快捷功能表。

語法

class CMFCColorPopupMenu : public CMFCPopupMenu

成員

公用建構函式

名稱	描述
CMFCColorPopupMenu：：CMFCColorPopupMenu	建構 `CMFCColorPopupMenu` 物件。
`CMFCColorPopupMenu::~CMFCColorPopupMenu`	解構函式。

公用方法

名稱	描述
CMFCColorPopupMenu：：CreateTearOffBar	建立可停駐的卸除色彩列。（覆寫 CMFCPopupMenu：：CreateTearOffBar.）
CMFCColorPopupMenu：：GetMenuBar	會傳回內嵌在快顯功能表中的CMFCPopupMenuBar 。（覆寫 CMFCPopupMenu：：GetMenuBar.）
`CMFCColorPopupMenu::GetThisClass`	由架構用來取得與這個類別類型相關聯之 CRuntimeClass 物件的指標。
CMFCColorPopupMenu：：SetPropList	設定內嵌 `CMFCColorBar` 物件的屬性方格控件物件。

資料成員

名稱	描述
`m_bEnabledInCustomizeMode`	布爾值，決定是否要顯示色列。
`m_wndColorBar`	`CMFCColorBar`提供色彩選取的物件。

備註

這個類別會繼承類別的 CMFCPopupMenu 快捷功能表功能，並管理 CMFCColorBar 提供色彩選取的物件。當工具列架構處於自定義模式且 m_bEnabledInCustomizeMode 成員設定為 FALSE 時，不會顯示色條物件。如需自定義模式的詳細資訊，請參閱 CMFCToolBar：：IsCustomizeMode

如需的詳細資訊 CMFCColorBar，請參閱 CMFCColorBar 類別。

繼承階層架構

需求

標頭： afxcolorpopupmenu.h

CMFCColorPopupMenu：：CMFCColorPopupMenu

建構 CMFCColorPopupMenu 物件。

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

參數

顏色
[in]架構顯示在快捷功能表上的色彩陣列。

color
[in]默認選取的色彩。

lpszAutoColor
[in]自動 （預設）色彩按鈕的文字標籤，或 NULL。

自動按鈕的標準標籤為 [自動]。

lpszOtherColor
[in]另一個按鈕的文字標籤，其中顯示更多色彩選擇，或 NULL。

另一個按鈕的標準標籤是 [更多色彩...]。

lpszDocColors
[in]檔色彩按鈕的文字標籤。檔色彩調色盤會列出檔目前使用的所有色彩。

lstDocColors
[in]檔目前使用的色彩清單。

nColumns
[in]色彩陣列具有的數據行數目。

nHorzDockRows
[in]色彩列水準停駐時所擁有的數據列數目。

nVertDockColumns
[in]色彩列垂直停駐時所擁有的數據行數目。

colorAutomatic
[in]當您按鍵時，架構套用的預設色彩。

uiCommandID
[in]色彩列控件命令標識碼。

bStdColorDlg
[in]布爾值，指出是否要顯示標準系統色彩對話框或 CMFCColorDialog 對話框。

pParentBtn
[in]父按鈕的指標。

nID
[in]命令標識碼。

備註

每個多載建構函式都會將 m_bEnabledInCustomizeMode 成員設定為 FALSE。

範例

下列範例示範如何建構 CMFCColorPopupMenu 物件。

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

建立可停駐的卸除色彩列。

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

參數

pWndMain
[in]卸除列之父視窗的指標。

uiID
[in]卸除列的命令標識碼。

lpszName
[in]卸除列的視窗文字。

傳回值

新卸除控件列物件的指標。

備註

這個方法會建立 CMFCColorBar 類別物件，並將它轉換成 CPane 類別指標。您可以使用 MFC 類別物件類型轉型中所述的其中一個轉型巨集，將此值轉換為 CMFCColorBar 類別指標。

CMFCColorPopupMenu：：GetMenuBar

會傳回內嵌在快顯功能表中的CMFCPopupMenuBar 。

virtual CMFCPopupMenuBar* GetMenuBar();

傳回值

內嵌 CMFCPopupMenuBar的指標。

備註

色彩快捷功能表具有內嵌的CMFCPopupMenuBar Class 物件。如果您的應用程式使用不同的內嵌類型，請覆寫衍生類別中的這個方法。

CMFCColorPopupMenu：：SetPropList

設定內嵌 CMFCColorBar 物件的屬性方格控件物件。

void SetPropList(CMFCPropertyGridCtrl* pWndList);

參數

pWndList
[in]屬性方格控件物件的指標。

另請參閱

階層架構圖表
 類別

共用方式為