Класс CMFCColorBar

Статья
02/20/2013

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

class CMFCColorBar : public CMFCPopupMenuBar

Члены

Защищенные конструкторы

Имя	Описание
CMFCColorBar::CMFCColorBar	Создает объект CMFCColorBar.

Открытые методы

Имя	Описание
CMFCColorBar::ContextToSize	Вычисляет отраслевую вертикали и горизонтальные поля, которое требуется для кнопок в элементе управления области содержат цвета, а затем обрабатывает расположение этих кнопок.
CMFCColorBar::CreateControl	Создает окно элементе управления панель цвета, вложение его к объекту CMFCColorBar и изменяет размер элемента управления для размещения определенную палитру цветов.
CMFCColorBar::Create	Создает окно элементе управления панель цвета и вложение его к объекту CMFCColorBar.
CMFCColorBar::EnableAutomaticButton	Автоматическая кнопку показывать или скрывать.
CMFCColorBar::EnableOtherButton	Позволяет включить или отключить отображение диалогового окна, позволяющей пользователю выбрать дополнительные цвета.
CMFCColorBar::GetColor	Извлекает выбранный цвет.
CMFCColorBar::GetCommandID	Извлекает идентификатор команды управления панели текущего цвета.
CMFCColorBar::GetHighlightedColor	Получает цвет, означает, что кнопку цвета имеет фокус; то есть кнопка горяча.
CMFCColorBar::GetHorzMargin	Извлекает горизонтальные поля, пространство между левой или правой ячейки, цвета и границы клиентской области.
CMFCColorBar::GetVertMargin	Извлекает вертикальные поля, расстояние между верхней или нижней ячейки, цвета и границы клиентской области.
CMFCColorBar::IsTearOff	Показывает, является ли текущая закрепляемая панель цвета.
CMFCColorBar::SetColor	Устанавливает цвет, который в настоящий момент выбраны.
CMFCColorBar::SetColorName	Устанавливает новое имя для указанного цвета.
CMFCColorBar::SetCommandID	Устанавливает новый идентификатор команды для управления панели цвета.
CMFCColorBar::SetDocumentColors	Задает список цветов, используемых в текущем документе.
CMFCColorBar::SetHorzMargin	Задает горизонтальные поля, пространство между левой или правой ячейки, цвета и границы клиентской области.
CMFCColorBar::SetVertMargin	Задает вертикальные поля, расстояние между верхней или нижней ячейки, цвета и границы клиентской области.

Защищенные методы

Имя	Описание
CMFCColorBar::AdjustLocations	Обрабатывает положения кнопки цвет на элементе управления панели цвета.
CMFCColorBar::AllowChangeTextLabels	Указывает, является ли текстовая подпись кнопки цвет может измениться.
CMFCColorBar::AllowShowOnList	Указывает, является ли объект управления панели цвета может появиться в списке панели инструментов во время процесса настройки.
CMFCColorBar::CalcSize	Вызываемый платформой как часть процесса вычисления макета.
CMFCColorBar::CreatePalette	Initalizes палитра с цветами в указанном массиве цветов.
CMFCColorBar::GetColorGridSize	Вычисляет количество строк и столбцов в сетке управления панели цвета.
CMFCColorBar::GetExtraHeight	Вычисляет дополнительную высоту которой текущая область цвета для отображения различных элементов как другое, цветов документа пользовательского интерфейса и т д
CMFCColorBar::InitColors	Инициализирует массив цветов с цветами палитры или определенной палитры значения по умолчанию.
CMFCColorBar::OnKey	Вызываемый платформой, когда пользователь отожмет кнопку клавиатуры.
CMFCColorBar::OnSendCommand	Вызываемый платформой, чтобы закрыть иерархия всплывающих элементов управления.
CMFCColorBar::OnUpdateCmdUI	Вызываемый платформой отображения, чтобы включить или отключить элемент пользовательского интерфейса элемента управления панели цвета перед элементом.
CMFCColorBar::OpenColorDialog	Открывает диалоговое окно цвет.
CMFCColorBar::Rebuild	Полностью перерисовывает элемент управления панель цвета.
CMFCColorBar::SelectPalette	Задает логическое палитру контекста заданного устройства в палитре родительской кнопки текущего элемента управления панели цвета.
CMFCColorBar::SetPropList	Задает элемент данных, защищенный m_pWndPropList в заданный указатель к элементу управления сетки свойств.
CMFCColorBar::ShowCommandMessageString	Запрашивает фреймовое окно, содержащее элемент управления панель цвета для обновления линия сообщения в строке состояния.

Защищенные члены данных

Имя	Описание
m_bInternal	Логическое поле, которое определяет, обрабатываются ли события мыши.Обычно события мыши обрабатываются, когда это поле TRUE и настройка FALSE.
m_bIsEnabled	Логическое значение, которое указывает, включен ли элемент управления.
m_bIsTearOff	Логическое значение, указывающее, поддерживает ли элемент управления панели закрепления цвета.
m_BoxSize	Объект CSize, который определяет размер ячейки в сетке панели цвета.
m_bShowDocColorsWhenDocked	Логическое значение, которое указывает, следует ли отображать цвета документа, если панель закреплена цвета.Дополнительные сведения см. в разделе CMFCColorBar::SetDocumentColors.
m_bStdColorDlg	Логическое значение, которое указывает, следует ли отображать стандартная система рисует диалоговое окно или диалоговое окно CMFCColorDialog.Дополнительные сведения см. в разделе CMFCColorBar::EnableOtherButton.
m_ColorAutomatic	COLORREF, которое сохраняет текущий автоцвет.Дополнительные сведения см. в разделе CMFCColorBar::EnableOtherButton.
m_ColorNames	Объект CMap, который связывает набор RGB закрашивает с их именами.
m_colors	CArray значений COLORREF, содержащее цветов, отображаемых в элементе управления панель цвета.
m_ColorSelected	Значение COLORREF, являющийся цветом, который в данный момент пользователь выбрал из элемента управления панели цвета.
m_lstDocColors	CList значений COLORREF, содержащее цвета, которые в данный момент используются в документе.
m_nCommandID	Целое число без знака, идентификатор команды кнопки цвета.
m_nHorzMargin	Целое число, горизонтальные поля между цветом застегивает в сетке цветов.
m_nHorzOffset	Целое число, представляющее горизонтальное смещение в центре кнопки цвета.Данное значение значительно если отображает кнопки СМС или вставке изображение в дополнение к цвету.
m_nNumColumns	Целое число, представляющее количество столбцов в сетке элементе управления панель цвета цветов.
m_nNumColumnsVert	Целое число, представляющее количество столбцов в вертикально, ориентированной сетке цветов.
m_nNumRowsHorz	Целое число, представляющее количество столбцов в ориентированной сетке цветов по горизонтали.
m_nRowHeight	Целое число, высота строки, цвета застегивает в сетке цветов.
m_nVertMargin	Целое число, вертикальные поля между цветом застегивает в сетке цветов.
m_nVertOffset	Целое число, вертикальное смещение в центре кнопки цвета.Данное значение значительно если отображает кнопки СМС или вставке изображение в дополнение к цвету.
m_Palette	CPalette цветов, используемых в элементе управления панель цвета.
m_pParentBtn	Указатель на объект CMFCColorButton, являющийся родительским для текущего кнопки.Данное значение значительно, если кнопка цвета в иерархии элементов управления " Панель инструментов или в элементе управления сетки свойств цвета.
m_pParentRibbonBtn	Указатель на объект CMFCRibbonColorButton, на ленте и родительское текущей кнопки.Данное значение значительно, если кнопка цвета в иерархии элементов управления " Панель инструментов или в элементе управления сетки свойств цвета.
m_pWndPropList	Указатель на объект CMFCPropertyGridCtrl.
m_strAutoColor	CString, текст, отображаемый на кнопке Автоматически.Дополнительные сведения см. в разделе CMFCColorBar::EnableAutomaticButton.
m_strDocColors	CString, текст, отображаемый на кнопке цветов документа.Дополнительные сведения см. в разделе CMFCColorBar::SetDocumentColors.
m_strOtherColor	CString, текст, отображаемый в другой кнопки.Дополнительные сведения см. в разделе CMFCColorBar::EnableOtherButton.

Заметки

Обычно объект CMFCColorBar не создается непосредственно.Вместо этого Класс CMFCColorMenuButton (используется в меню и панелей инструментов) или Класс CMFCColorButton создают объект CMFCColorBar.

Класс CMFCColorBar предоставляет следующие функциональные возможности:

Автоматически обрабатывает список цветов документа.
Сохраняет и получает ее состояние вместе с состоянием документа.
Управляет "автоматический".
Использует управление Класс CMFCColorPickerCtrl, чтобы выбрать пользовательский цвет.
Поддерживает "перемещаемое" состояние (при его создании с помощью Класс CMFCColorMenuButton).

Включать функции CMFCColorBar в приложение.

Создайте обычную кнопку меню и присвойте ей идентификатор, например ID_CHAR_COLOR.
В классе фреймового окна, переопределите метод CFrameWndEx::OnShowPopupMenu и замените обычную кнопку меню с объектом Класс CMFCColorMenuButton (путем вызова CMFCToolBar::ReplaceButton).
Установите все стили и включение или отключение функции объекта CMFCColorBar во время создания Класс CMFCColorMenuButton.Объект CMFCColorMenuButton динамически создает объект CMFCColorBar после того как платформа вызывает метод CreatePopupMenu.

При нажатии пользователем кнопки элементе управления панель цвета, границы используется макрос ON_COMMAND для уведомления родительский элемент управления панели цвета.В макросе, параметр идентификатор команды значения, присвоенного ему пользователем кнопки элементе управления панель цвета в шаге 1 (ID_CHAR_COLOR в этом примере).Дополнительные сведения см. в разделе Класс CMFCColorMenuButton классы, Класс CMFCColorButton, Класс CMFCColorPickerCtrl, Класс CFrameWndEx и Класс CMFCToolBar.

Пример

В следующем примере показано, как настроить панель цвета с помощью различных методов в классе CMFCColorBar.Методы устанавливают горизонтальной и вертикальной поля, включают другой кнопки, создают окно элементе управления панель цвета и наборы выбранный цвет.Данный пример является частью Создать образец элементов управления.

    CMFCColorBar m_wndColorBar;


...


    // set the margins
    m_wndColorBar.SetHorzMargin(0);
    m_wndColorBar.SetVertMargin(0);
    // enable the display of a dialog box that 
    // lets the user select more colors
    m_wndColorBar.EnableOtherButton(_T("Other..."));
    // create a color bar control window
    m_wndColorBar.CreateControl(this, rectColorBar, IDC_COLORBAR, 5 /* columns */);
    // set the currently selected color
    m_wndColorBar.SetColor(RGB(255, 0, 0));