Класс CMFCToolBar

Статья
06/10/2015

Класс CMFCToolBar напоминает Класс CToolBar, но обеспечивает дополнительную поддержку функций пользовательского интерфейса. Они включают плоские панели инструментов панели инструментов с образами горячими большие значки панели инструментов кнопки страничного навигатора, блокированных элементы управления " Главная панель текста под образов, фоновые изображения и со вкладками панели инструментов. Класс CMFCToolBar также содержит встроенную поддержку для настройки пользователя панелей инструментов и меню, между панелями инструментов и меню перетаскивания, кнопок полей со списком, кнопок полей ввода, цветов и кнопки сведения.

class CMFCToolBar : public CMFCBaseToolBar

Члены

Открытые конструкторы

Имя	Описание
CMFCToolBar::CMFCToolBar	Конструктор по умолчанию.
CMFCToolBar::~CMFCToolBar	Деструктор.

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

Имя	Описание
CMFCToolBar::AddBasicCommand	Добавление команды меню в список команд, которые отображаются всегда, когда пользователь открывает меню.
CMFCToolBar::AddCommandUsage	Увеличивает на единицу счетчик, который связан с данной командой.
CMFCToolBar::AddToolBarForImageCollection	Добавляет образы из ресурсов пользовательского интерфейса в коллекции изображений в приложении.
CMFCToolBar::AdjustLayout	Повторно вычисляет размер и положение панели инструментов. (Переопределяет метод CBasePane::AdjustLayout.)
CMFCToolBar::AdjustSize	Повторно вычисляет размер панели инструментов.
CMFCToolBar::AllowChangeTextLabels	Указывает, будут ли текстовые подписи можно отобразить с образами в кнопках панели инструментов.
CMFCToolBar::AreTextLabels	Указывает, отображаются ли текстовые подписи с образами в настоящее время на кнопках панели инструментов.
CMFCToolBar::AutoGrayInactiveImages	Включить или отключить автоматическое формирование неактивных изображений кнопок.
CMFCToolBar::ButtonToIndex	Возвращает индекс указанного объекта Класс CMFCToolBarButton в данной панели инструментов.
CMFCToolBar::CalcFixedLayout	Вычисляет горизонтальный размер панели инструментов. (Переопределяет CBasePane::CalcFixedLayout).
CMFCToolBar::CalcSize	Вызываемый платформой как часть процесса вычисления макета. (Переопределяет CPane::CalcSize).
CMFCToolBar::CanHandleSiblings	Определяет, находятся ли панель инструментов и его элемент того же уровня на одну и ту же область.
CMFCToolBar::CleanUpImages	Освобождает ресурсы системы, выбранные для образов панели инструментов.
CMFCToolBar::CleanUpLockedImages	Освобождает ресурсы системы, выбранные для образов блокированных панели инструментов.
CMFCToolBar::CanBeClosed	Указывает, может ли пользователь закрыть панель инструментов. (Переопределяет CBasePane::CanBeClosed).
CMFCToolBar::CanBeRestored	Определяет, может ли система получить панели инструментов в исходное состояние после настройки.
CMFCToolBar::CanFocus	Определяет, является ли панель может получать фокус. (Переопределяет CBasePane::CanFocus).
CMFCToolBar::CanHandleSiblings	Определяет, находятся ли панель инструментов и его элемент того же уровня на одну и ту же область.
CMFCToolBar::CommandToIndex	Возвращает индекс кнопок на панели инструментов с указанным идентификатором команды
CMFCToolBar::Create	Создает объект CMFCToolBar.
CMFCToolBar::CreateEx	Создает объект CMFCToolBar, использующий дополнительные параметры стиля, в виде крупных значков.
CMFCToolBar::Deactivate	Деактивирует панель инструментов.
CMFCToolBar::EnableCustomizeButton	Позволяет включить или отключить кнопку Добавить или удалить кнопки , которая отображается на окончании панели инструментов.
CMFCToolBar::EnableDocking	Включает закрепления панелей в главного фрейма. (Переопределяет CBasePane::EnableDocking).
CMFCToolBar::EnableLargeIcons	Включение или отключение крупных значков на кнопках панели инструментов.
CMFCToolBar::EnableQuickCustomization	Позволяет включить или отключить быструю настройку панелей инструментов, чтобы пользователь мог нажать кнопку ключ Alt и перетащите в новое расположение.
CMFCToolBar::EnableReflections	Включение или отключение отражение команды.
CMFCToolBar::EnableTextLabels	Включение или отключение текстовые подписи с образами кнопки панели инструментов.
CMFCToolBar::FromHandlePermanent	Извлекает указатель на объект CMFCToolBar, содержащий заданный дескриптор окна.
CMFCToolBar::GetAllButtons	Возвращает только для чтения список кнопок на панели инструментов.
CMFCToolBar::GetAllToolbars	Возвращает только для чтения список всех панелей инструментов в приложении.
CMFCToolBar::GetBasicCommands	Возвращает только для чтения список основных команд, определенных в приложении.
CMFCToolBar::GetButton	Возвращает указатель на объект CMFCToolBarButton, имеющий указанный индекс кнопки панели инструментов.
CMFCToolBar::GetButtonInfo	Возвращает идентификатор команды, стиль и индекс изображения кнопок по указанному индексу.
CMFCToolBar::GetButtonSize	Возвращает измерения каждой кнопки на панели инструментов.
CMFCToolBar::GetButtonStyle	Возвращает текущий стиль кнопки панели инструментов, найдено по указанному индексу.
CMFCToolBar::GetButtonText	Возвращает текстовую подпись кнопки, имеющий указанный индекс.
CMFCToolBar::GetColdImages	Возвращает указатель на коллекцию холодных изображений кнопок панели инструментов в приложении.
CMFCToolBar::GetColumnWidth	Возвращает ширину кнопки панели инструментов.
CMFCToolBar::GetCommandButtons	Возвращает список кнопок с указанным идентификатором команды из всех панелей инструментов в приложении.
CMFCToolBar::GetCount	Получает число кнопок и разделителей на панели инструментов.
CMFCToolBar::GetCustomizeButton	Извлекает указатель на объект CMFCCustomizeButton, который связан с панелью инструментов.
CMFCToolBar::GetDefaultImage	Возвращает индекс по умолчанию образа для кнопок панели инструментов с указанным идентификатором команды
CMFCToolBar::GetDisabledImages	Возвращает указатель на коллекции изображений, используемых при отключенных кнопок панели инструментов в приложении.
CMFCToolBar::GetDisabledMenuImages	Возвращает указатель на коллекции изображений, используемых при отключенных кнопок меню в приложении.
CMFCToolBar::GetDroppedDownMenu	Извлекает указатель на объект button меню, который в данный момент указывает его подменю.
CMFCToolBar::GetGrayDisabledButtons	Определяет, является ли образы отключенных кнопок уменьшен яркостьые версии обычных изображений кнопок или принятый из коллекции отключенных изображений кнопок.
CMFCToolBar::GetHighlightedButton	Возвращает указатель на кнопке панели инструментов, которая в настоящий момент выделена.
CMFCToolBar::GetHotBorder	Определяет, является ли высокий- отслеживаются кнопки панели инструментов.
CMFCToolBar::GetHotTextColor	Возвращает цвет текста выбранных кнопок панели инструментов.
CMFCToolBar::GetHwndLastFocus	Возвращает дескриптор окна, которое имело фокус ввода непосредственно перед панель инструментов сделала.
CMFCToolBar::GetIgnoreSetText	Определяет, является ли игнорируются вызовы задать метки кнопки.
CMFCToolBar::GetImageSize	Возвращает текущий размер изображений кнопок панели инструментов.
CMFCToolBar::GetImages	Возвращает указатель на коллекции образов кнопку по умолчанию в приложении.
CMFCToolBar::GetImagesOffset	Возвращает смещение индекса, который используется для получения изображений кнопок панели инструментов для данной панели инструментов в глобальном списке изображений кнопок панели инструментов.
CMFCToolBar::GetInvalidateItemRect	Извлекает область клиентской области, должен перерисовать для кнопки по заданному индексу.
CMFCToolBar::GetItemID	Возвращает идентификатор команды кнопки панели инструментов по указанному индексу.
CMFCToolBar::GetItemRect	Возвращает ограничивающий прямоугольник для кнопки по указанному индексу.
CMFCToolBar::GetLargeColdImages	Возвращает указатель на коллекции больших холодных изображений кнопок панели инструментов в приложении.
CMFCToolBar::GetLargeDisabledImages	Возвращает указатель на коллекции больших отключенных изображений кнопок панели инструментов в приложении.
CMFCToolBar::GetLargeImages	Возвращает указатель на коллекции больших изображений кнопок панели инструментов в приложении.
CMFCToolBar::GetLockedColdImages	Возвращает указатель на коллекцию холодных блокированных изображений на панели инструментов.
CMFCToolBar::GetLockedDisabledImages	Возвращает указатель на коллекции образов заблокированных заблокированным на панели инструментов.
CMFCToolBar::GetLockedImages	Возвращает указатель на коллекции блокированных изображений кнопок на панели инструментов.
CMFCToolBar::GetLockedImageSize	Возвращает размер по умолчанию образов блокированных панели инструментов.
CMFCToolBar::GetLockedMenuImages	Возвращает указатель на коллекции образов блокированных меню панели инструментов на панели инструментов.
CMFCToolBar::GetMenuButtonSize	Возвращает размер кнопок меню в приложении.
CMFCToolBar::GetMenuImageSize	Возвращает размер изображений кнопок меню в приложении.
CMFCToolBar::GetMenuImages	Возвращает указатель на коллекции изображений кнопок меню в приложении.
CMFCToolBar::GetOrigButtons	Извлекает коллекцию настраиваемых, отличного от кнопок панели инструментов.
CMFCToolBar::GetOrigResetButtons	Извлекает коллекцию настраиваемых возврата, отличного от кнопок панели инструментов.
CMFCToolBar::GetResourceID	Извлекает идентификатор ресурса панели инструментов.
CMFCToolBar::GetRouteCommandsViaFrame	Определяет, какой объект или владелец, отправляют родительским кадром команд на панели инструментов.
CMFCToolBar::GetRowHeight	Возвращает высоту кнопок панели инструментов.
CMFCToolBar::GetShowTooltips	Указывает, отображаются ли всплывающие подсказки для кнопки панели инструментов.
CMFCToolBar::GetSiblingToolBar	Извлекает одноуровневый элемент панели инструментов.
CMFCToolBar::GetUserImages	Возвращает указатель на коллекцию определяемых пользователем изображений кнопок панели инструментов в приложении.
CMFCToolBar::HitTest	Возвращает индекс кнопки панели инструментов, найдено в заданной позиции.
CMFCToolBar::InsertButton	Представляет кнопку на панели инструментов.
CMFCToolBar::InsertSeparator	Вставляет разделитель на панели инструментов.
CMFCToolBar::InvalidateButton	Делает недействительной клиентской области кнопки панели инструментов, существует по указанному индексу.
CMFCToolBar::IsAddRemoveQuickCustomize	Указывает, может ли пользователь добавлять или удалять кнопки панели инструментов с помощью пункта меню Настроить.
CMFCToolBar::IsAltCustomizeMode	Указывает, используется ли быстрой настройкой для перетаскивания.
CMFCToolBar::IsAutoGrayInactiveImages	Определяет, является ли включающие автоматическое формирование неактивных (выделенных), изображений кнопок.
CMFCToolBar::IsBasicCommand	Определяет, является ли команда в списке основных команд.
CMFCToolBar::IsButtonExtraSizeAvailable	Определяет, является ли панель инструментов может отображаться кнопки, удлиняли границы.
CMFCToolBar::IsButtonHighlighted	Определяет, является ли выделена кнопки на панели инструментов.
CMFCToolBar::IsCommandPermitted	Указывает, разрешена ли команда.
CMFCToolBar::IsCommandRarelyUsed	Указывает, используется ли команда редко (см. CMFCToolBar::SetCommandUsageOptions).
CMFCToolBar::IsCustomizeMode	Определяет, является ли границы панели инструментов в режиме настройки.
CMFCToolBar::IsDragButton	Определяет, перетащив ли кнопка панели инструментов.
CMFCToolBar::IsExistCustomizeButton	Определяет, содержит ли панель инструментов кнопку Настроить.
CMFCToolBar::IsFloating	Указывает, располагается ли панель инструментов.
CMFCToolBar::IsLargeIcons	Указывает, отображаются ли панели инструментов в приложении в настоящее время крупные значки.
CMFCToolBar::IsLastCommandFromButton	Указывает, была ли выполнена команда отправлена последним из указанной кнопки панели инструментов.
CMFCToolBar::IsLocked	Определяет, является ли панель инструментов блокирована.
CMFCToolBar::IsOneRowWithSibling	Определяет, находятся ли панель инструментов и панели инструментов одноуровневого на одну и ту же строку.
CMFCToolBar::IsUserDefined	Определяет, является ли панель инструментов определяется пользователем.
CMFCToolBar::LoadBitmap	Загружает образы панели инструментов из ресурсов приложения.
CMFCToolBar::LoadBitmapEx	Загружает образы панели инструментов из ресурсов приложения. Включает большие изображений.
CMFCToolBar::LoadParameters	Загружает глобальные параметры панели инструментов из реестра Windows.
CMFCToolBar::LoadState	Загружает сведения о состоянии панели инструментов из реестра Windows. (Переопределяет CPane::LoadState).
CMFCToolBar::LoadToolBar	Загружает панель инструментов из ресурсов приложения.
CMFCToolBar::LoadToolBarEx	Загружает панель инструментов из ресурсов приложения с помощью вспомогательного класса CMFCToolBarInfo, чтобы разрешить приложению использовать большие изображений.
CMFCToolBar::OnChangeHot	Вызываемый платформой, когда пользователь выбирает кнопку на панели инструментов.
CMFCToolBar::OnFillBackground	Вызываемый платформой из CBasePane::DoPaint для заливки фона панели инструментов.
CMFCToolBar::OnReset	Извлекает панели инструментов в исходное состояние.
CMFCToolBar::OnSetAccData	(Переопределяет CBasePane::OnSetAccData).
CMFCToolBar::OnSetDefaultButtonText	Извлекает текст кнопки панели инструментов в состоянии по умолчанию.
CMFCToolBar::OnUpdateCmdUI	Для внутреннего использования.
CMFCToolBar::RemoveAllButtons	Удаляет все кнопки на панели инструментов.
CMFCToolBar::RemoveButton	Удаляет кнопку с указанным индексом из панели инструментов.
CMFCToolBar::RemoveStateFromRegistry	Удаляет сведения о состоянии панели инструментов из реестра Windows.
CMFCToolBar::ReplaceButton	Заменяет кнопка панели инструментов с кнопкой панели инструментов.
CMFCToolBar::ResetAll	Извлекает все панели инструментов в исходном состояниям.
CMFCToolBar::ResetAllImages	Удаляет все коллекции образа панели инструментов в приложении.
CMFCToolBar::RestoreOriginalstate	Получает исходное состояние панели инструментов.
CMFCToolBar::SaveState	Сохраняет сведения о состоянии панели инструментов в реестре Windows. (Переопределяет CPane::SaveState).
CMFCToolBar::Serialize	(Переопределяет CBasePane::Serialize).
CMFCToolBar::SetBasicCommands	Задает список команд, которые отображаются всегда, когда пользователь открывает меню.
CMFCToolBar::SetButtonInfo	Задает идентификатор команды, стиль и идентификатор образа кнопки панели инструментов.
CMFCToolBar::SetButtonStyle	Задает стиль кнопок панели инструментов с заданного индекса.
CMFCToolBar::SetButtonText	Задает текстовую подпись кнопки панели инструментов.
CMFCToolBar::SetButtons	Задает кнопки панели инструментов.
CMFCToolBar::SetCommandUsageOptions	Указывает, когда редко используемые команды не отображаются в меню приложения.
CMFCToolBar::SetCustomizeMode	Включение или отключение режима настройки для всех панелей инструментов в приложении.
CMFCToolBar::SetGrayDisabledButtons	Определяет, можно ли уменьшить яркость отключенные кнопки на панели инструментов или если отключенные образы используются для отключенных кнопок.
CMFCToolBar::SetHeight	Задает высоту панели инструментов.
CMFCToolBar::SetHotBorder	Определяет, является ли высокий- отслеживаются кнопки панели инструментов.
CMFCToolBar::SetHotTextColor	Задает цвет текста для кнопок панели инструментов в активном состоянии.
CMFCToolBar::SetLargeIcons	Указывает, отображаются ли кнопки панели инструментов крупные значки.
CMFCToolBar::SetLockedSizes	Устанавливает размеры блокированных и блокировать изображений кнопок на панели инструментов.
CMFCToolBar::SetMenuSizes	Задает размер кнопок меню, панели инструментов и их изображений.
CMFCToolBar::SetNonPermittedCommands	Задает список команд, которые не могут быть исполнитьы пользователем.
CMFCToolBar::SetOneRowWithSibling	Располагает панелью инструментов и его одноуровневый элемент на том же гребет.
CMFCToolBar::SetPermament	Указывает, может ли пользователь закрыть панель инструментов.
CMFCToolBar::SetRouteCommandsViaFrame	Определяет, отправляет ли родительский кадр или владелец команды на панели инструментов.
CMFCToolBar::SetShowTooltips	Указывает, отображаются ли границы всплывающие подсказки.
CMFCToolBar::SetSiblingToolBar	Определяет одноуровневый элемент панели инструментов.
CMFCToolBar::SetSizes	Определяет размер кнопок и образы для всех панелях инструментов.
CMFCToolBar::SetToolBarBtnText	Определяет свойства кнопок на панели инструментов.
CMFCToolBar::SetTwoRowsWithSibling	Располагает панелью инструментов и его элемент того же уровня на отдельные строки.
CMFCToolBar::SetUserImages	Задает коллекцию определяемых пользователем изображений в приложении.
CMFCToolBar::StretchPane	Растянет панель инструментов по вертикали или по горизонтали. (Переопределяет CBasePane::StretchPane).
CMFCToolBar::TranslateChar	Выполняет команду кнопки, если код заданного ключа соответствует сочетанию клавиш являются допустимыми.
CMFCToolBar::UpdateButton	Обновляет состояние указанной кнопки.
CMFCToolBar::WrapToolBar	Перемещает кнопки панели инструментов в заданном измерений.

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

Имя	Описание
CMFCToolBar::AllowShowOnList	Указывает, отображается ли панель инструментов в списке на панели Панели инструментов диалогового окна Настроить.
CMFCToolBar::CalcMaxButtonHeight	Вычисляет максимальную высоту кнопок на панели инструментов.
CMFCToolBar::DoPaint	Обновляет панель инструментов.
CMFCToolBar::DrawButton	Обновляет кнопки панели инструментов.
CMFCToolBar::DrawSeparator	Обновляет разделителя на панели инструментов.
CMFCToolBar::OnUserToolTip	Вызываемый платформой, когда подсказки для кнопки будет отображаться.

Элементы данных

Имя	Описание
CMFCToolBar::m_bDontScaleImages	Определяет, является ли масштабирование или не образы панели инструментов на высоком режиме ТОЧКА НА ДЮЙМ.
CMFCToolBar::m_dblLargeImageRatio	Определяет отношение между измерением (высоты или ширины) больших изображений и измерением обычных изображений.

Заметки

Для включения объект CMFCToolBar в приложении, выполните следующие действия:

Добавьте объект CMFCToolBar к главному фреймовому окно.
При обработке сообщения WM_CREATE для главного фреймового окна, вызовите метод CMFCToolBar::Create или CMFCToolBar::CreateEx чтобы создать панель инструментов и задать его стиль.
Вызовите CBasePane::EnableDocking, чтобы определить стиль закрепления.

Ввод специальной кнопки, в поле со списком или раскрывающаяся панель инструментов, резервирует думмичную кнопку в родительском ресурсе и заменяет думмичная кнопка во время выполнения с помощью CMFCToolBar::ReplaceButton. Дополнительные сведения см. в разделе Пошаговое руководство. Размещение элементов управления на панели инструментов.

CMFCToolBar базовый класс для классов Класс CMFCMenuBar, Класс CMFCPopupMenuBar и Класс CMFCDropDownToolBar библиотеки MFC.

Пример

В следующем примере показано, как использовать различные методы класса CMFCToolBar. Примере показано, как задать текст метки окна панели инструментов, чтобы задать границы, чтобы задать стиль панели и включить кнопку Добавить или удалить кнопки, которая отображается на окончании панели инструментов. Этот фрагмент кода является частью Пример demo IE.

 CMFCToolBar     m_wndToolBar;


...


    m_wndToolBar.SetWindowText (_T("Standard"));
    m_wndToolBar.SetBorders ();

    //------------------------------------ 
    // Remove toolbar gripper and borders: 
    //------------------------------------
    m_wndToolBar.SetPaneStyle (m_wndToolBar.GetPaneStyle() &
        ~(CBRS_GRIPPER | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));

    m_wndToolBar.EnableCustomizeButton (TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."));