Поделиться через


Класс CMFCColorPopupMenu

Представляет всплывающее меню, которое пользователи используют для выбора цветов в документе или приложении.

Синтаксис

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 , предоставляющий выделение цвета.

Замечания

Этот класс наследует CMFCColorBar функциональные возможности всплывающего CMFCPopupMenu меню класса и управляет объектом, предоставляющим выделение цвета. Если платформа панели инструментов находится в режиме настройки, а m_bEnabledInCustomizeMode элемент имеет значение FALSE, объект цветовой панели не отображается. Дополнительные сведения о режиме настройки см. в разделе CMFCToolBar::IsCustomizeMode

Дополнительные сведения см. в CMFCColorBarразделе "Класс CMFCColorBar".

Иерархия наследования

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

CMFCPopupMenu

CMFCColorPopupMenu

Требования

Заголовок: 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. Это значение можно вернуть к указателю класса CMFCColorBar с помощью одного из макросов приведения, описанных в разделе "Приведение типов объектов классов MFC".

CMFCColorPopupMenu::GetMenuBar

Возвращает CMFCPopupMenuBar, внедренный в всплывающее меню.

virtual CMFCPopupMenuBar* GetMenuBar();

Возвращаемое значение

Указатель на внедренный CMFCPopupMenuBar.

Замечания

Всплывающее меню цвета содержит внедренный объект класса CMFCPopupMenuBar. Переопределите этот метод в производном классе, если приложение использует другой внедренный тип.

CMFCColorPopupMenu::SetPropList

Задает объект элемента управления сеткой свойств внедренного CMFCColorBar объекта.

void SetPropList(CMFCPropertyGridCtrl* pWndList);

Параметры

pWndList
[in] Указатель на объект элемента управления сеткой свойств.

См. также

Диаграмма иерархии
Классы