Класс `CMFCToolBar`

Статья
10/12/2023

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

Дополнительные сведения см. в исходном коде, расположенном в установке Visual Studio, например %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Синтаксис

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`	Извлекает указатель на объект кнопки меню, который в настоящее время отображает его вложенное меню.
`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`	Указывает, следует ли масштабировать изображения панели инструментов в режиме высокого уровня DPI.
`CMFCToolBar::m_dblLargeImageRatio`	Задает соотношение между измерением (высота или ширина) больших изображений и измерением регулярных изображений.

Замечания

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

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

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

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

Пример

В приведенном ниже примере демонстрируется использование различных методов класса CMFCToolBar . В примере показано, как задать текст метки окна панели инструментов, задать границы, задать стиль области и включить кнопку "Добавить " или "Удалить кнопку ", которая отображается на конце панели инструментов. Этот фрагмент кода является частью примера демонстрации 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..."));

Требования

Заголовок.afxtoolbar.h

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

CMFCToolBar

`CMFCToolBar::AddBasicCommand`

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

static void __stdcall AddBasicCommand(UINT uiCmd);

Параметры

uiCmd
[in] Указывает команду, добавляемую.

Замечания

Базовая команда всегда отображается при открытии меню. Этот метод имеет смысл, когда пользователь выбирает для просмотра недавно использованных команд.

CMFCToolBar::SetBasicCommands Используйте метод, чтобы задать список команд, которые всегда отображаются при открытии пользователем меню. CMFCToolBar::GetBasicCommands Используйте метод для получения списка основных команд, используемых приложением.

`CMFCToolBar::AddCommandUsage`

Увеличивается по одному счетчику, связанному с данной командой.

static void __stdcall AddCommandUsage(UINT uiCommand);

Параметры

uiCommand
[in] Задает счетчик команд для увеличения.

Замечания

Платформа вызывает этот метод, когда пользователь выбирает элемент меню.

Платформа использует счетчики команд для отображения недавно используемых элементов меню.

Этот метод увеличивает счетчик команд с помощью CMFCCmdUsageCount::AddCmd метода.

`CMFCToolBar::AddToolBarForImageCollection`

Добавляет изображения из ресурсов пользовательского интерфейса в коллекцию образов в приложении.

static BOOL __stdcall AddToolBarForImageCollection(
    UINT uiResID,
    UINT uiBmpResID=0,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Параметры

uiResID
[in] Идентификатор ресурса панели инструментов с изображениями для загрузки.

uiBmpResID
[in] Идентификатор ресурса растрового изображения с изображениями панели инструментов.

uiColdResID
[in] Идентификатор ресурса растрового изображения с "холодными" изображениями панели инструментов.

uiMenuResID
[in] Идентификатор ресурса растрового изображения с изображениями меню.

uiDisabledResID
[in] Идентификатор ресурса растрового изображения с отключенными изображениями панели инструментов.

uiMenuDisabledResID
[in] Идентификатор ресурса растрового изображения с отключенными изображениями меню.

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

TRUE Значение , если метод выполнен успешно; FALSE Значение , если uiResID или uiBmpResID не указать допустимые ресурсы, или возникает другая ошибка.

Замечания

Вызовите этот метод, чтобы загрузить растровое изображение с изображениями панели инструментов и добавить его в коллекцию изображений панели инструментов. Этот метод создает временный объект панели инструментов и вызовы CMFCToolBar::LoadToolBar.

`CMFCToolBar::AdjustLayout`

Пересчитывает размер и позицию панели инструментов.

virtual void AdjustLayout();

Замечания

Вызовите этот метод при создании панели инструментов для пересчета его размера и положения.

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

Переопределите этот метод, чтобы предоставить собственный динамический макет в классах, производных от CMFCToolbar.

`CMFCToolBar::AdjustSize`

Пересчитывает размер панели инструментов.

void AdjustSize();

Замечания

Этот метод гарантирует, что панель инструментов помещается в границы родительского кадра. Этот метод ничего не делает, если панель инструментов не имеет родительского кадра.

Метод CMFCToolBar::AdjustLayout вызывает этот метод для пересчета размера, если родительский элемент панели инструментов не CMFCReBar является объектом.

`CMFCToolBar::AllowChangeTextLabels`

Указывает, можно ли отображать текстовые метки под изображениями на кнопках панели инструментов.

virtual BOOL AllowChangeTextLabels() const;

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

TRUE Значение , если разрешено отображать текстовые метки под изображениями; в противном случае FALSE.

Замечания

Этот метод вызывается диалоговым окном настройки, чтобы определить, следует ли включить текстовые метки проверка на странице "Панели инструментов" для выбранной панели инструментов.

Реализация по умолчанию возвращает значение TRUE.

Переопределите этот метод в объекте, производном от CMFCToolBar и возвращаемом FALSE , если пользователь не хочет, чтобы пользователь решил, отображаются ли текстовые метки на кнопках панели инструментов под изображениями.

`CMFCToolBar::AllowShowOnList`

Определяет, отображается ли панель инструментов в списке панелей инструментов на панели инструментов диалогового окна "Настройка ".

virtual BOOL AllowShowOnList() const;

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

TRUE Значение , если объект панели инструментов можно отобразить в списке на странице настройки панели инструментов; в противном случае FALSE.

Замечания

Этот метод вызывается платформой, чтобы определить, должен ли список на странице настройки панели инструментов включать определенный объект, производный от CMFCToolBar.

Реализация по умолчанию всегда возвращает значение TRUE. Переопределите этот метод, если вы не хотите, чтобы панель инструментов отображалась в списке панелей инструментов в диалоговом окне настройки.

`CMFCToolBar::AreTextLabels`

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

BOOL AreTextLabels() const;

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

TRUE Если кнопки панели инструментов отображают текстовые метки под изображениями; в противном случае FALSE.

Замечания

Используется CMFCToolBar::EnableTextLabels для указания того, отображается ли текст. Значение по умолчанию — FALSE. Вызов, CMFCToolBar::AllowChangeTextLabels чтобы указать, может ли пользователь изменить этот параметр в диалоговом окне настройки.

`CMFCToolBar::AutoGrayInactiveImages`

Включает или отключает автоматическое создание неактивных изображений кнопок.

static void AutoGrayInactiveImages(
    BOOL bEnable=TRUE,
    int nGrayImagePercentage=0,
    BOOL bRedrawAllToolbars=TRUE);

Параметры

bEnable
[in] Логическое значение, указывающее, следует ли выглушить неактивные изображения. Если этот параметр имеет значение TRUE, неактивные изображения неактивны. В противном случае неактивные изображения не будут отключены.

nGrayImagePercentage
[in] Указывает процент света для неактивных изображений. В противном bEnable случае FALSEэто значение игнорируется.

bRedrawAllToolbars
[in] Логическое значение, указывающее, следует ли перерисовывать все панели инструментов в приложении. Если этот параметр задан TRUE, этот метод перерисовывает все панели инструментов.

Замечания

В противном случае bEnableTRUEплатформа используется nGrayImagePercentage для создания неактивных образов из обычных образов. В противном случае необходимо предоставить набор неактивных изображений с помощью CMFCToolBar::GetColdImages метода. По умолчанию этот параметр отключен.

Дополнительные сведения о параметре nGrayImagePercentage см. в разделе CMFCToolBarImages::GrayImages.

`CMFCToolBar::ButtonToIndex`

Возвращает индекс указанного CMFCToolBarButton объекта класса на этой панели инструментов.

int ButtonToIndex(const CMFCToolBarButton* pButton) const;

Параметры

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

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

pButton Индекс в внутреннем списке кнопок панели инструментов или -1, если указанная кнопка не находится на этой панели инструментов.

`CMFCToolBar::CalcFixedLayout`

Вычисляет горизонтальный размер панели инструментов.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Параметры

bStretch
[in] TRUE Чтобы растянуть панель инструментов до размера родительского кадра.

bHorz
[in] TRUE для горизонтального выравнивания панели инструментов; FALSE чтобы настроить панель инструментов по вертикали.

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

Объект CSize , указывающий размер панели инструментов.

Замечания

Этот метод вычисляет размер панели инструментов с помощью CMFCToolBar::CalcLayout метода. Он передает LM_STRETCH флаг для dwMode параметра, если bStretch есть TRUE. Он передает флаг, LM_HORZ если bHorz есть TRUE.

Пример VisualStudioDemo, использующий этот метод.

`CMFCToolBar::CalcMaxButtonHeight`

Вычисляет максимальную высоту кнопок на панели инструментов.

virtual int CalcMaxButtonHeight();

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

Максимальная высота кнопок.

Замечания

Этот метод вычисляет максимальную высоту всех кнопок панели инструментов на панели инструментов. Высота может отличаться в зависимости от таких факторов, как текущее состояние закрепления панели инструментов.

Переопределите этот метод в классе, производным от CMFCToolBar предоставления собственного вычисления высоты.

`CMFCToolBar::CalcSize`

Вызывается платформой в рамках процесса вычисления макета.

virtual CSize CalcSize(BOOL bVertDock);

Параметры

bVertDock
[in] TRUE Значение , чтобы указать, что панель инструментов закреплена по вертикали; FALSE Чтобы указать, что панель инструментов закреплена по горизонтали.

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

Объект CSize , указывающий общий размер кнопок на панели инструментов.

Замечания

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

Если панель инструментов не содержит кнопок, этот метод возвращает зарезервированный размер одной кнопки с помощью CMFCToolBar::GetButtonSize метода.

`CMFCToolBar::CanBeClosed`

Указывает, может ли пользователь закрыть панель инструментов.

virtual BOOL CanBeClosed() const;

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

TRUE Значение , если панель инструментов может быть закрыта пользователем; в противном случае FALSE.

Замечания

Платформа вызывает этот метод, чтобы определить, может ли пользователь закрыть панель инструментов. Если метод возвращаетсяTRUE, платформа включает SC_CLOSE команду в системном меню панели инструментов, а пользователь может закрыть панель инструментов с помощью поля проверка в списке панелей инструментов в диалоговом окне настройки.

Реализация по умолчанию возвращает значение TRUE. Переопределите этот метод в классе, производном от CMFCToolBar создания объектов панели инструментов, которые не могут быть закрыты пользователем.

`CMFCToolBar::CanBeRestored`

Определяет, может ли система восстановить панель инструментов до исходного состояния после настройки.

virtual BOOL CanBeRestored() const;

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

TRUE Значение , если панель инструментов может быть восстановлена из ресурсов приложения; в противном случае FALSE.

Замечания

Платформа вызывает этот метод, чтобы определить, можно ли вернуть панель инструментов в исходное состояние после настройки. Исходное состояние загружается из ресурсов приложения.

Если CanBeRestored возвращается TRUE, страница "Панели инструментов " диалогового окна настройки включает кнопку "Сброс " для выбранной панели инструментов.

Реализация по умолчанию возвращается TRUE , если исходный идентификатор ресурса панели инструментов при загрузке не равен нулю. Обычно невозможно восстановить только определяемые пользователем панели инструментов.

Этот метод можно переопределить CanBeRestored для настройки этого поведения в производных классах.

`CMFCToolBar::CanFocus`

Указывает, может ли область получать фокус.

virtual BOOL CanFocus() const;

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

Этот метод возвращает FALSE.

Замечания

Этот метод переопределяет реализацию базового класса, CBasePane::CanFocusтак как объекты панели инструментов не могут получать фокус.

`CMFCToolBar::CanHandleSiblings`

Определяет, расположена ли панель инструментов и панель того же уровня в одной области.

BOOL CanHandleSiblings();

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

TRUE Значение , если панель инструментов имеет одноуровневый элемент и панель инструментов и ее одноуровневый элемент находятся на одной панели; в противном случае FALSE.

Замечания

Внутренний CMFCCustomizeButton::CreatePopupMenu метод вызывает этот метод, чтобы определить, как отобразить всплывающее меню "Настройка ". Если этот метод возвращается TRUE, платформа отображает кнопки "Показать" в одной строке или "Показать кнопки" на двух строках .

Использование этого метода обычно не требуется. Чтобы включить кнопку "Настройка ", которая отображается на панели инструментов, вызовите CMFCToolBar::EnableCustomizeButton метод. Чтобы включить кнопки "Показать" в одной строке или "Показать кнопки" на двух строках , вызовите вызов CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::CleanUpImages`

Освобождает системные ресурсы, выделенные для изображений панели инструментов.

static void CMFCToolBar::CleanUpImages();

Замечания

Платформа вызывает этот метод при завершении работы приложения.

`CMFCToolBar::CleanUpLockedImages`

Освобождает системные ресурсы, выделенные для заблокированных образов панели инструментов.

void CleanUpLockedImages();

Замечания

Вызовите этот метод при изменении визуального стиля приложения. Пример VisualStudioDemo, использующий этот метод.

`CMFCToolBar::CommandToIndex`

Возвращает индекс кнопки на панели инструментов с указанным идентификатором команды.

int CommandToIndex(
    UINT nIDFind,
    int iIndexFirst=0) const;

Параметры

nIDFind
[in] Указывает идентификатор команды.

iIndexFirst
[in] Указывает начальный индекс для начала.

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

Отсчитываемый от нуля индекс кнопки панели инструментов, если метод выполнен успешно; -1, если нет кнопки с указанным идентификатором.

Замечания

Объект CMFCToolBar поддерживает внутренний список кнопок на панели инструментов. Вызовите эту функцию, чтобы получить индекс кнопки в списке с идентификатором команды кнопки.

Если iIndex значение больше 0, этот метод игнорирует любую кнопку на панели инструментов с индексом меньше iIndex.

`CMFCToolBar::Create`

Создает объект CMFCToolBar.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT nID=AFX_IDW_TOOLBAR);

Параметры

pParentWnd
[in] Указатель на родительское окно панели инструментов.

dwStyle
[in] Стиль панели инструментов. Список стилей элементов управления и кнопки см. в пакете SDK для Windows.

nID
[in] Идентификатор дочернего окна панели инструментов.

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

TRUE Значение , если этот метод выполнен успешно; в противном случае FALSE.

Замечания

Этот метод создает панель управления и присоединяет ее к панели инструментов. Он создает панель управления с ТБSTYLE_FLAT стилем. Вызовите CMFCToolBar::CreateEx , если требуется другой стиль панели управления.

`CMFCToolBar::CreateEx`

CMFCToolBar Создает объект, использующий дополнительные параметры стиля, например большие значки.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle=TBSTYLE_FLAT,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    CRect rcBorders=CRect(1,
    1,
    1,
    1),
    UINT nID=AFX_IDW_TOOLBAR);

Параметры

pParentWnd
[in] Указатель на родительское окно панели инструментов.

dwCtrlStyle
[in] Дополнительные стили для создания внедренного объекта панели управления.

dwStyle
[in] Стиль панели инструментов. Список соответствующих стилей см. в разделе "Стили элементов управления панели инструментов" и "Кнопка".

rcBorders
[in] CRect Объект, указывающий ширину границ окна панели инструментов.

nID
[in] Идентификатор дочернего окна панели инструментов.

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

Ненулевое значение, если этот метод выполнен успешно; в противном случае — 0.

Замечания

Этот метод создает панель управления и присоединяет ее к панели инструментов.

Вызовите этот метод вместо того, CMFCToolBar::Create когда требуется предоставить определенные стили. Например, задайте dwCtrlStyle для TBSTYLE_FLAT | TBSTYLE_TRANSPARENT создания панели инструментов, которая напоминает панели инструментов, используемые Интернетом Обозреватель 4.

Пример

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

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

`CMFCToolBar::Deactivate`

Деактивирует панель инструментов.

virtual void Deactivate();

Замечания

Этот метод деактивирует панель инструментов, удалив фокус с выделенной кнопки панели инструментов. Платформа вызывает этот метод, когда панель инструментов теряет фокус или уничтожается.

`CMFCToolBar::DoPaint`

Переопределяет панель инструментов.

virtual void DoPaint(CDC* pDC);

Параметры

pDC
[in] Указатель на контекст устройства.

Замечания

Этот метод вызывается платформой, когда часть панели инструментов должна быть переопределена.

Переопределите этот метод, чтобы настроить внешний вид объекта, производный от CMFCToolBar.

`CMFCToolBar::DrawButton`

Переопределяет кнопку панели инструментов.

virtual BOOL DrawButton(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CMFCToolBarImages* pImages,
    BOOL bHighlighted,
    BOOL bDrawDisabledImages);

Параметры

pDC
[in] Указатель на контекст устройства.

pButton
[in] Указатель на кнопку для рисования.

pImages
[in] Указатель на изображения панели инструментов.

bHighlighted
[in] TRUE Значение , если кнопка выделена; в противном случае FALSE.

bDrawDisabledImages
[in] TRUE Значение , если отключенные кнопки неактивны; в противном случае FALSE.

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

TRUE Значение , если кнопка была переопределена; FALSE Значение , если кнопка скрыта.

Замечания

Этот CMFCToolBar::DrawButton метод вызывает этот метод, когда необходимо переопредеить кнопку панели инструментов.

Переопределите этот метод, если вы хотите настроить внешний вид кнопок на панели инструментов.

`CMFCToolBar::DrawSeparator`

Переопределяет разделитель на панели инструментов.

virtual void DrawSeparator(
    CDC* pDC,
    const CRect& rect,
    BOOL bHorz);

Параметры

pDC
[in] Указатель на контекст устройства.

rect
[in] Ограничивающий прямоугольник расположения, в котором рисуется разделитель, в пикселях.

bHorz
[in] TRUE Значение FALSE .

Замечания

CMFCToolBar::DoPaint вызывает этот метод для каждого CMFCToolBar::DrawSeparator объекта, имеющего TBBS_SEPARATOR стиль, вместо вызова CMFCToolBar::DrawButton этих кнопок.

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

`CMFCToolBar::EnableCustomizeButton`

Включает или отключает кнопку "Настройка", которая отображается на панели инструментов.

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    const CString& strCustomizeText,
    BOOL bQuickCustomize=TRUE);

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    UINT uiCustomizeTextResId,
    BOOL bQuickCustomize=TRUE);

Параметры

bEnable
[in] Включает или отключает кнопку "Настройка".

iCustomizeCmd
[in] Идентификатор команды кнопки "Настройка".

strCustomizeText
[in] Текстовая метка кнопки "Настройка".

uiCustomizeTextResId
[in] Идентификатор строки ресурса метки кнопки "Настройка".

bQuickCustomize
[in] Включает или отключает параметр "Добавить или удалить кнопки" в меню, раскрывающемся из кнопки.

Замечания

Если iCustomizeCmd значение равно -1, платформа отображает кнопку "Настроить", если несколько кнопок панели инструментов не помещаются в область панели инструментов. Кнопка отображает двойную стрелку влево или шеврон, которая указывает на наличие дополнительных кнопок.

Если iCustomizeCmd указан допустимый идентификатор команды и bEnableTRUEесть, кнопка "Настройка" всегда отображается. Кнопка имеет небольшую стрелку вниз и открывает меню, содержащее команду. Эта команда использует текстовую метку, указанную в strCustomizeText. Если bQuickCustomize это также TRUE, в меню отображается параметр "Добавить" или "Удалить кнопки ".

Платформа динамически добавляет в меню все кнопки, которые не помещаются в область панели инструментов перед элементом, указанным в iCustomizeCmdпараметре. Шеврон отображается рядом со стрелкой вниз.

`CMFCToolBar::EnableDocking`

Включает закрепление панели к главному кадру.

virtual void EnableDocking(DWORD dwAlignment);

Параметры

dwAlignment
[in] Указывает выравнивание док-станции для включения.

Замечания

Этот метод расширяет реализацию базового класса, CBasePane::EnableDockingзадав CBasePane::m_dwControlBarStyle для элемента данных значение AFX_CBRS_FLOAT. Затем этот метод передается dwAlignment в реализацию базового класса.

`CMFCToolBar::EnableLargeIcons`

Включает или отключает большие значки на кнопках панели инструментов.

void EnableLargeIcons(BOOL bEnable);

Параметры

bEnable
[in] TRUE Чтобы включить большие значки, FALSE отключите большие значки.

Замечания

По умолчанию включены большие значки.

`CMFCToolBar::EnableQuickCustomization`

Включает или отключает быструю настройку панелей инструментов, чтобы пользователь мог нажать клавишу ALT и перетащить кнопку в новое расположение.

static void EnableQuickCustomization(BOOL bEnable=TRUE);

Параметры

bEnable
[in] TRUE чтобы включить быструю настройку, FALSE чтобы отключить быструю настройку.

`CMFCToolBar::EnableReflections`

Включает или отключает отражение команд.

void EnableReflections(BOOL bEnable = TRUE);

Параметры

bEnable
[in] TRUE для включения отражения команд; FALSE для отключения отражения команд.

Замечания

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

Дополнительные сведения о отражении команд см. в разделе TN062: сообщение Рефлексия для элементов управления Windows.

`CMFCToolBar::EnableTextLabels`

Включает или отключает текстовые метки под изображениями кнопки панели инструментов.

void EnableTextLabels(BOOL bEnable=TRUE);

Параметры

bEnable
TRUE Значение , если текстовые метки отображаются под изображениями кнопки панели инструментов; в противном случае FALSE.

Замечания

Если текстовые метки включены, все кнопки на панели инструментов увеличены, чтобы предоставить место для отображения меток под изображениями. В диалоговом окне настройки есть надпись "Показать текст" проверка на странице "Панели инструментов". Когда пользователь выбирает панель инструментов и проверка этот параметр, платформа вызывает EnableTextLabels выбранную панель инструментов. Вы можете отключить поле проверка для объекта, производного от CMFCToolBar него, путем FALSE возврата из CMFCToolBar::AllowChangeTextLabels него.

`CMFCToolBar::FromHandlePermanent`

Извлекает указатель на CMFCToolBar объект, содержащий заданный дескриптор окна.

static CMFCToolBar* __stdcall FromHandlePermanent(HWND hwnd);

Параметры

hwnd
[in] Дескриптор окна для поиска.

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

Указатель на CMFCToolBar объект, содержащий заданный дескриптор окна, или NULL если соответствующий CMFCToolBar объект не существует.

Замечания

Этот общий метод проверяет каждую панель инструментов в приложении для CMFCToolBar объекта, содержащего заданный дескриптор окна.

`CMFCToolBar::GetAllButtons`

Возвращает список кнопок только для чтения на панели инструментов.

const CObList& GetAllButtons() const;

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

Константная ссылка на объект Class, содержащий коллекцию CMFCToolBarButton объектов класса.CObList

`CMFCToolBar::GetAllToolbars`

Возвращает список всех панелей инструментов только для чтения в приложении.

static const CObList& GetAllToolbars();

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

Ссылка const на CObList объект Class , содержащий коллекцию CMFCToolBar объектов.

`CMFCToolBar::GetBasicCommands`

Возвращает список базовых команд, определенных в приложении только для чтения.

static const CList<UINT,UINT>& GetBasicCommands();

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

Ссылка const на CList объект класса , содержащий коллекцию базовых команд.

Замечания

Добавьте базовые команды путем вызова CMFCToolBar::AddBasicCommand или CMFCToolBar::SetBasicCommands.

`CMFCToolBar::GetButton`

Возвращает указатель на CMFCToolBarButton объект Class по указанному индексу.

CMFCToolBarButton* GetButton(int iIndex) const;

Параметры

iIndex
[in] Указывает индекс возвращаемой кнопки.

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

Указатель на кнопку панели инструментов, если она существует; или NULL если такой кнопки нет.

`CMFCToolBar::GetButtonInfo`

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

void GetButtonInfo(
    int nIndex,
    UINT& nID,
    UINT& nStyle,
    int& iImage) const;

Параметры

nIndex
[in] Указывает индекс кнопки в списке кнопок на панели инструментов.

nID
[out] Идентификатор команды кнопки.

nStyle
[out] Стиль кнопки.

iImage
[out] Индекс изображения для кнопки.

Замечания

Метод GetButtonInfo находит кнопку панели инструментов по указанному индексу и извлекает идентификатор команды, стиль и индекс изображения кнопки.

Если кнопка по указанному индексу не существует, платформа задает nID значение 0 и nStyleiImage значение -1 при возврате метода.

`CMFCToolBar::GetButtonSize`

Возвращает размеры каждой кнопки на панели инструментов.

CSize GetButtonSize() const;

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

CSize Объект класса, указывающий размеры каждой кнопки на панели инструментов.

Замечания

Вызов CMFCToolBar::SetSizes или CMFCToolBar::SetLockedSizes настройка измерений каждой кнопки на панели инструментов.

`CMFCToolBar::GetButtonStyle`

Возвращает текущий стиль кнопки панели инструментов, расположенной по указанному индексу.

UINT GetButtonStyle(int nIndex) const;

Параметры

nIndex
[in] Указывает индекс кнопки панели инструментов.

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

Значение, указывающее стиль кнопки панели инструментов. . Список возможных стилей элементов управления см. в разделе "Стили элементов управления ToolBar".

Замечания

Вызов CMFCToolBar::SetButtonStyle для задания стиля кнопки панели инструментов

`CMFCToolBar::GetButtonText`

Возвращает текстовую метку кнопки с указанным индексом.

CString GetButtonText(int nIndex) const;

void GetButtonText(
    int nIndex,
    CString& rString) const;

`CMFCToolBar::GetCommandButtons`

Возвращает список кнопок с указанным идентификатором команды со всех панелей инструментов в приложении.

static int GetCommandButtons(
    UINT uiCmd,
    CObList& listButtons);

Параметры

uiCmd
[in] Идентификатор команды кнопок.

listButtons
[out] Ссылка на CObList объект класса , который получает список кнопок панели инструментов.

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

Количество кнопок с указанным идентификатором команды.

`CMFCToolBar::GetCount`

Возвращает количество кнопок и разделителей на панели инструментов.

int GetCount() const;

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

Количество кнопок и разделителей на панели инструментов.

`CMFCToolBar::GetCustomizeButton`

Извлекает указатель на CMFCCustomizeButton объект, связанный с панелью инструментов.

CMFCCustomizeButton* GetCustomizeButton();

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

Указатель на CMFCCustomizeButton объект, связанный с панелью инструментов.

Замечания

Этот метод извлекает кнопку "Настройка", которая отображается в конце панели инструментов. CMFCToolBar::EnableCustomizeButton Используйте метод, чтобы добавить кнопку "Настроить" на панель инструментов.

Можно вызвать CMFCToolBar::IsExistCustomizeButton метод, чтобы определить, содержит ли панель инструментов допустимый CMFCCustomizeButton объект.

`CMFCToolBar::GetDefaultImage`

Возвращает индекс изображения по умолчанию для кнопки панели инструментов с указанным идентификатором команды.

static int GetDefaultImage(UINT uiID);

Параметры

BOOL GetIgnoreSetText() const;

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

TRUE Значение , если вызовы для задания меток кнопки игнорируются; FALSEв противном случае .

Замечания

`CMFCToolBar::GetImages`

Возвращает указатель на коллекцию изображений кнопок по умолчанию в приложении.

static CMFCToolBarImages* GetImages();

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

Указатель на CMFCToolBarImages объект Class , содержащий коллекцию образов по умолчанию для всех панелей инструментов в приложении.

Замечания

Этот общий метод предоставляет доступ к коллекции всех образов панели инструментов по умолчанию для приложения. CMFCToolBar::LoadBitmap Вызовите метод для добавления изображений в коллекцию.

`CMFCToolBar::GetImageSize`

Возвращает текущий размер изображений кнопки панели инструментов.

CSize GetImageSize() const;

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

CSize Объект класса, представляющий текущий размер изображений кнопки панели инструментов.

`CMFCToolBar::GetImagesOffset`

Возвращает смещение индекса, используемое для поиска изображений кнопки панели инструментов для этой панели инструментов в глобальном списке изображений кнопок панели инструментов.

int GetImagesOffset() const;

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

Смещение индекса изображений панели инструментов.

Замечания

Все изображения панели инструментов по умолчанию хранятся в глобальном CMFCToolBarImages списке классов . Изображения для каждой кнопки на панели инструментов хранятся последовательно в этом списке. Чтобы вычислить индекс изображения, добавьте индекс кнопки на панели инструментов в смещение начала списка изображений для этой кнопки панели инструментов.

Вызов CMFCToolBar::ButtonToIndex , чтобы получить индекс кнопки панели инструментов, указав указатель на кнопку.

Вызов CMFCToolBar::GetImages для получения указателя на коллекцию изображений панели инструментов.

`CMFCToolBar::GetInvalidateItemRect`

Извлекает регион клиентской области, которую необходимо перезапустить для кнопки по указанному индексу.

virtual void GetInvalidateItemRect(
    int nIndex,
    LPRECT lpRect) const;

Параметры

nIndex
[in] Индекс кнопки, для которой требуется получить клиентская область.

lpRect
[out] Указатель на RECT объект, который получает регион клиентской области.

Замечания

Параметр lpRect не должен быть NULL. Если кнопка не существует в указанном индексе, lpRect получает объект, инициализированный RECT до нуля.

`CMFCToolBar::GetItemID`

Возвращает идентификатор команды кнопки панели инструментов по указанному индексу.

UINT GetItemID(int nIndex) const;

Параметры

nIndex
[in] Указывает индекс кнопки панели инструментов.

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

Идентификатор команды кнопки панели инструментов; или ноль, если кнопка с указанным индексом не существует.

`CMFCToolBar::GetItemRect`

Возвращает ограничивающий прямоугольник кнопки по указанному индексу.

virtual void GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Параметры

nIndex
[in] Указывает индекс кнопки панели инструментов.

lpRect
[out] Указатель на CRect объект, получающий координаты ограничивающего прямоугольника изображения.

Замечания

Объект, CRect для которого lpRect задано значение 0, если кнопка по указанному индексу не существует.

Пример

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

CMFCToolBar m_wndToolBar;

CRect rectToolBar;
m_wndToolBar.GetItemRect(0, &rectToolBar);

`CMFCToolBar::GetLargeColdImages`

Возвращает указатель на коллекцию изображений с большой холодной кнопкой панели инструментов в приложении.

static CMFCToolBarImages* GetLargeColdImages();

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

Указатель на коллекцию больших холодных изображений.

Замечания

Холодные изображения — это изображения, используемые, когда пользователь не взаимодействует с кнопками панели инструментов. Вызов CMFCToolBar::LoadBitmapEx для загрузки больших холодных изображений.

`CMFCToolBar::GetLargeDisabledImages`

Возвращает указатель на коллекцию изображений с отключенной кнопкой на панели инструментов в приложении.

static CMFCToolBarImages* GetLargeDisabledImages();

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

Указатель на коллекцию изображений с отключенной кнопкой панели инструментов.

Замечания

Большие изображения — это большие версии обычных изображений кнопок панели инструментов. Вызов CMFCToolBar::LoadBitmapEx или CMFCToolBar::LoadBitmap загрузка больших изображений.

`CMFCToolBar::GetLargeImages`

Возвращает указатель на коллекцию изображений больших кнопок панели инструментов в приложении.

static CMFCToolBarImages* GetLargeImages();

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

Указатель на коллекцию изображений больших кнопок панели инструментов.

Замечания

Большие изображения — это большие версии обычных изображений кнопок панели инструментов. Вызов CMFCToolBar::LoadBitmapEx для загрузки больших изображений.

`CMFCToolBar::GetLockedColdImages`

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

CMFCToolBarImages* GetLockedColdImages();

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

Указатель на коллекцию заблокированных холодных изображений или NULL если панель инструментов не заблокирована.

Замечания

Заблокированные изображения — это версии обычных образов кнопки панели инструментов, которые платформа использует, когда пользователь не может настроить панель инструментов. Холодные изображения — это изображения, используемые, когда пользователь не взаимодействует с кнопками панели инструментов.

Этот метод возвращается NULL , если панель инструментов не заблокирована. Этот метод также создает сбой утверждения в сборках отладки, если панель инструментов не заблокирована. Дополнительные сведения о заблокированных панелях инструментов см. в статье CMFCToolBar::IsLocked.

CMFCToolBar::LoadBitmapEx Вызовите метод для загрузки заблокированных холодных образов.

`CMFCToolBar::GetLockedDisabledImages`

Возвращает указатель на коллекцию заблокированных отключенных изображений на панели инструментов.

CMFCToolBarImages* GetLockedDisabledImages();

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

Указатель на коллекцию заблокированных отключенных изображений или NULL если панель инструментов не заблокирована.

Замечания

Заблокированные изображения — это версии обычных образов кнопки панели инструментов, которые платформа использует, когда пользователь не может настроить панель инструментов. Отключенные изображения — это изображения, которые платформа использует при наличии стиля кнопки TBBS_DISABLED .

CMFCToolBar::LoadBitmapEx Вызовите метод для загрузки заблокированных отключенных образов.

`CMFCToolBar::GetLockedImages`

Возвращает указатель на коллекцию заблокированных изображений кнопок на панели инструментов.

CMFCToolBarImages* GetLockedImages();

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

Указатель на коллекцию заблокированных изображений кнопок панели инструментов или NULL если панель инструментов не заблокирована.

Замечания

`CMFCToolBar::GetLockedImageSize`

Возвращает размер заблокированных изображений панели инструментов по умолчанию.

CSize GetLockedImageSize() const;

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

Структура CSize , указывающая размер заблокированных изображений панели инструментов или пустую CSize структуру, если панель инструментов не заблокирована.

Замечания

Этот метод возвращает структуру с нулевой шириной и нулевой CSize высотой, если панель инструментов не заблокирована. Этот метод также создает сбой утверждения в сборках отладки, если панель инструментов не заблокирована. Дополнительные сведения о заблокированных панелях инструментов см. в статье CMFCToolBar::IsLocked.

CMFCToolBar::SetLockedSizes Вызовите метод, чтобы указать размер заблокированного изображения.

`CMFCToolBar::GetLockedMenuImages`

Возвращает указатель на коллекцию заблокированных изображений меню панели инструментов на панели инструментов.

CMFCToolBarImages* GetLockedMenuImages();

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

Указатель на коллекцию заблокированных изображений меню панели инструментов или NULL если панель инструментов не заблокирована.

Замечания

Заблокированные изображения — это версии обычных образов меню панели инструментов, которые платформа использует, когда пользователь не может настроить панель инструментов.

CMFCToolBar::LoadBitmapEx Вызовите метод для загрузки заблокированных изображений меню.

`CMFCToolBar::GetMenuButtonSize`

Возвращает размер кнопок меню в приложении.

static CSize GetMenuButtonSize();

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

Объект CSize , представляющий размер кнопок меню в пикселях.

Замечания

Размер кнопок меню на панелях инструментов поддерживается как глобальная переменная и может быть получен этим статическим методом.

Вызов CMFCToolBar::SetMenuSizes для задания этой глобальной переменной.

`CMFCToolBar::GetMenuImages`

Возвращает указатель на коллекцию изображений кнопок меню в приложении.

static CMFCToolBarImages* GetMenuImages();

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

Указатель на коллекцию изображений меню.

Замечания

CMFCToolBar::LoadBitmapEx Вызовите метод для загрузки изображений меню.

CMFCToolBar::SetMenuSizes Вызовите метод, чтобы задать размер кнопок и их изображений.

`CMFCToolBar::GetMenuImageSize`

Возвращает размер изображений кнопки меню в приложении.

static CSize GetMenuImageSize();

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

Объект CSize , представляющий размер изображений меню.

Замечания

Этот метод возвращает размер изображений на кнопках меню панели инструментов, которые поддерживаются в качестве глобальной переменной. Вызов CMFCToolBar::SetMenuSizes для задания этой глобальной переменной.

`CMFCToolBar::GetOrigButtons`

Извлекает коллекцию не настроенных кнопок панели инструментов.

const CObList& GetOrigButtons() const;

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

Ссылка на список не настраиваемых кнопок панели инструментов.

Замечания

Платформа создает копию кнопок панели инструментов перед настройкой пользователем. Метод CMFCToolBar::SetButtons добавляет копию каждой кнопки в предоставленный массив в список исходных кнопок. Метод CMFCToolBar::RestoreOriginalState восстанавливает исходное состояние панели инструментов, загрузив его из файла ресурса.

Чтобы задать список исходных кнопок для панели инструментов, вызовите CMFCToolBar::SetOrigButtons метод.

`CMFCToolBar::GetOrigResetButtons`

Извлекает коллекцию не настроенных кнопок сброса панели инструментов.

const CObList& GetOrigResetButtons() const;

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

Ссылка на список не настроенных кнопок сброса панели инструментов.

Замечания

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

Метод CMFCToolBar::SetButtons добавляет копию каждой кнопки панели инструментов в список исходных кнопок сброса после вызова CMFCToolBar::OnReset метода. Вы можете переопределить CMFCToolBar::OnReset метод, чтобы настроить внешний вид кнопок после нажатия кнопки сброса.

`CMFCToolBar::GetResourceID`

Извлекает идентификатор ресурса панели инструментов.

UINT GetResourceID() const;

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

Идентификатор ресурса панели инструментов.

Замечания

Вызовите метод, CMFCToolBar::LoadToolBarEx чтобы задать идентификатор ресурса панели инструментов.

`CMFCToolBar::GetRouteCommandsViaFrame`

Определяет, какой объект, родительский кадр или владелец, отправляет команды на панель инструментов.

BOOL GetRouteCommandsViaFrame();

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

Ненулевое значение, если родительский кадр отправляет команды на панель инструментов; Значение 0, если владелец отправляет команды на панель инструментов.

Замечания

По умолчанию родительский кадр отправляет команды на панель инструментов. Вызов CMFCToolBar::SetRouteCommandsViaFrame для изменения этого поведения.

Если этот метод возвращает ненулевое значение, можно получить указатель на родительский объект кадра с помощью CMFCToolBar::GetCommandTarget метода. Пример VisualStudioDemo, использующий этот метод.

`CMFCToolBar::GetRowHeight`

Возвращает высоту кнопок панели инструментов.

virtual int GetRowHeight() const;

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

Высота кнопок панели инструментов в пикселях.

Замечания

Платформа вызывает этот метод для вычисления макета панели инструментов. Переопределите этот метод в производном классе, чтобы указать другую высоту для панели инструментов.

`CMFCToolBar::GetShowTooltips`

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

static BOOL GetShowTooltips();

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

TRUE Если подсказки инструментов отображаются для кнопок панели инструментов; в противном случае FALSE.

Замечания

По умолчанию отображаются советы по инструменту. Этот статический флаг можно изменить, вызвав .CMFCToolBar::SetShowTooltips

`CMFCToolBar::GetSiblingToolBar`

Извлекает одноуровневый элемент панели инструментов.

CMFCToolBar* GetSiblingToolBar();

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

Указатель на панель инструментов брата.

Замечания

Дополнительные сведения о том, как включить кнопки "Показать" в одной строке и показывать кнопки на двух строках , см. в разделе CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::GetUserImages`

Возвращает указатель на коллекцию пользовательских изображений кнопки панели инструментов в приложении.

static CMFCToolBarImages* GetUserImages();

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

Указатель на коллекцию пользовательских изображений кнопок панели инструментов для всех панелей инструментов в приложении.

Замечания

CMFCToolBar::SetUserImages Вызовите метод, чтобы задать коллекцию пользовательских образов в приложении.

`CMFCToolBar::HitTest`

Возвращает индекс кнопки панели инструментов, расположенной в указанной позиции.

virtual int HitTest(CPoint point);

Параметры

point
[in] Точка для тестирования в координатах клиента.

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

Индекс кнопки, расположенной в указанной позиции, или -1, если такой кнопки нет или кнопка является разделителем.

`CMFCToolBar::InsertButton`

Вставляет кнопку на панель инструментов.

virtual int InsertButton(
    const CMFCToolBarButton& button,
    INT_PTR iInsertAt=-1);

virtual int InsertButton(
    CMFCToolBarButton* pButton,
    int iInsertAt=-1);

Параметры

button
[in] Указывает кнопку для вставки.

iInsertAt
[in] Указывает отсчитываемую от нуля позицию для вставки кнопки.

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

Позиция, в которой была вставлена кнопка или -1, если возникает ошибка.

Замечания

Если iInsertAt значение равно -1, этот метод добавляет кнопку в конец списка кнопок панели инструментов.

CMFCToolBar::InsertSeparator Вызовите метод для вставки разделителя на панель инструментов.

`CMFCToolBar::InsertSeparator`

Вставляет разделитель на панель инструментов.

virtual int InsertSeparator(INT_PTR iInsertAt=-1);

Параметры

iInsertAt
[in] Указывает позицию отсчитываемой от нуля для вставки разделителя. Этот параметр должен быть больше 0.

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

Позиция, в которой был вставлен разделитель или -1 при возникновении ошибки.

Замечания

Вызовите этот метод, чтобы вставить разделитель между двумя существующими кнопками. Если iInsertAt значение равно -1, этот метод добавляет разделитель в конец списка кнопок панели инструментов.

Этот метод нельзя использовать для добавления разделителя на пустую панель инструментов.

CMFCToolBar::InsertButton Вызовите метод для вставки кнопки на панель инструментов.

`CMFCToolBar::InvalidateButton`

Отменяет клиентская область кнопки панели инструментов, которая существует в указанном индексе.

CMFCToolBarButton* InvalidateButton(int nIndex);

Параметры

nIndex
[in] Отсчитываемый от нуля индекс кнопки на панели инструментов.

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

Указатель на CMFCToolBarButton объект, который существует в указанном индексе, или NULL если такой объект отсутствует.

Замечания

Платформа вызывает этот метод при обновлении клиентской области, связанной с кнопкой панели инструментов. Он вызывает CWnd::InvalidateRect метод с прямоугольником клиента объекта, существующего CMFCToolBarButton в указанном индексе.

`CMFCToolBar::IsAddRemoveQuickCustomize`

Определяет, может ли пользователь добавлять или удалять кнопки панели инструментов с помощью параметра меню "Настройка ".

BOOL IsAddRemoveQuickCustomize();

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

TRUE Значение />, если пользователь может использовать параметр меню "Настройка" для изменения панели инструментов; в противном случае FALSE.

Замечания

`CMFCToolBar::IsAltCustomizeMode`

Указывает, используется ли быстрая настройка для перетаскивания кнопки. Если включена быстрая настройка, пользователь может нажать и удерживать клавиши ALT и перетаскивать кнопку в новое расположение.

static BOOL __stdcall IsAltCustomizeMode();

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

TRUE Если быстрая настройка используется для перетаскивания кнопки; FALSEв противном случае .

Замечания

`CMFCToolBar::IsAutoGrayInactiveImages`

Указывает, включено ли автоматическое создание неактивных (не выделенных) изображений кнопок.

static BOOL IsAutoGrayInactiveImages();

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

TRUE Значение FALSE.

Замечания

Вы можете включить или отключить автоматическое отключение неактивных изображений путем вызова CMFCToolBar::AutoGrayInactiveImages.

`CMFCToolBar::IsBasicCommand`

Определяет, находится ли команда в списке основных команд.

static BOOL IsBasicCommand(UINT uiCmd);

Параметры

uiCmd
[in] Указывает команду для проверка.

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

TRUE Значение , если указанная команда принадлежит списку основных команд; в противном случае FALSE.

Замечания

Этот статический метод определяет, принадлежит ли команда, указанная uiCmd в глобальном списке базовых команд. Вы можете изменить список базовых команд, вызвав CMFCToolBar::AddBasicCommand или CMFCToolBar::SetBasicCommands.

`CMFCToolBar::IsButtonExtraSizeAvailable`

Определяет, может ли панель инструментов отображать кнопки с расширенными границами.

virtual BOOL IsButtonExtraSizeAvailable() const;

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

TRUE Если панель может отображать кнопки с дополнительным размером границы; в противном случае FALSE.

Замечания

Объект панели инструментов возвращается TRUE , если он может отображать кнопки с расширенными границами. Кнопка панели инструментов вызывает этот метод при обработке CMFCToolBarButton::OnChangeParentWnd уведомления и задает соответствующий внутренний флаг дополнительного размера границы. Этот внутренний флаг может быть получен позже путем вызова CMFCToolBarButton::IsExtraSize.

Переопределите этот метод в классе, производном от CMFCToolBar и возвращаемого TRUE , если панель может отображать кнопки панели инструментов с дополнительным размером границы и возвращать FALSE в противном случае. Реализация по умолчанию возвращает значение TRUE.

`CMFCToolBar::IsButtonHighlighted`

Определяет, выделена ли указанная кнопка.

BOOL IsButtonHighlighted(int iButton) const;

Параметры

iButton
[in] Указывает индекс кнопки панели инструментов.

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

TRUE Значение , если выделена указанная кнопка; FALSEв противном случае .

Замечания

`CMFCToolBar::IsCommandPermitted`

Определяет, разрешена ли команда.

static BOOL IsCommandPermitted(UINT uiCmd);

Параметры

uiCmd
[in] Указывает команду для проверка.

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

TRUE Значение , если указанная команда разрешена; в противном случае FALSE.

Замечания

Этот статический метод определяет, принадлежит ли команда, указанная uiCmd в глобальном списке не разрешенных команд.

Список не разрешенных команд можно изменить путем вызова CMFCToolBar::SetNonPermittedCommands.

`CMFCToolBar::IsCommandRarelyUsed`

Определяет, используется ли команда редко.

static BOOL IsCommandRarelyUsed(UINT uiCmd);

Параметры

uiCmd
[in] Указывает команду для проверка.

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

TRUE Если указанная команда редко используется; в противном случае FALSE.

Замечания

Метод IsCommandRarelyUsed возвращается FALSE при возникновении одного или нескольких следующих условий:

Указанная команда относится к списку базовых команд
Указанная команда является одной из стандартных команд.
Платформа находится в режиме настройки
Список основных команд пуст
Более 20% вызовов команд являются вызовами указанной команды.

`CMFCToolBar::IsCustomizeMode`

Указывает, находится ли платформа панели инструментов в режиме настройки.

static BOOL IsCustomizeMode();

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

TRUE Значение FALSE.

Замечания

Вы можете переключать режим настройки, вызывая.CMFCToolBar::SetCustomizeMode

Платформа изменяет режим, когда пользователь вызывает диалоговое окно настройки ( CMFCToolBarsCustomizeDialog класс).

`CMFCToolBar::IsDragButton`

Определяет, перетаскивается ли кнопка панели инструментов.

BOOL IsDragButton(const CMFCToolBarButton* pButton) const;

Параметры

pButton
[in] Указатель на кнопку панели инструментов.

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

TRUE Значение , если указанная кнопка перетаскивается; FALSEв противном случае .

Замечания

`CMFCToolBar::IsExistCustomizeButton`

Определяет, содержит ли панель инструментов кнопку "Настройка ".

BOOL IsExistCustomizeButton();

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

TRUE Значение , если панель инструментов содержит кнопку "Настройка "; в противном случае FALSE.

Замечания

Если этот метод возвращается, метод возвращает TRUEуказатель на кнопку "Настройка", CMFCToolBar::GetCustomizeButton которая отображается в конце панели инструментов.

CMFCToolBar::EnableCustomizeButton Используйте метод, чтобы добавить кнопку "Настроить" на панель инструментов.

`CMFCToolBar::IsFloating`

Определяет, плавает ли панель инструментов.

virtual BOOL IsFloating() const;

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

TRUE Значение , если панель инструментов плавает; FALSEв противном случае .

`CMFCToolBar::IsLargeIcons`

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

static BOOL IsLargeIcons();

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

TRUE Значение , если приложение использует большие значки; в противном случае FALSE.

Замечания

Вызов CMFCToolBar::SetLargeIcons переключателя между большими значками и обычными значками.

Платформа автоматически изменяет режим, когда пользователь переключает большие значки проверка на странице "Параметры" диалогового окна "Параметры".

`CMFCToolBar::IsLastCommandFromButton`

Определяет, была ли отправлена последняя выполненная команда с указанной кнопки панели инструментов.

static BOOL IsLastCommandFromButton(CMFCToolBarButton* pButton);

Параметры

pButton
[in] Указатель на кнопку.

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

TRUE Значение , если последняя команда была отправлена из кнопки, pButton указывающей; в противном случае FALSE.

Замечания

Этот метод получает указатель на MSG структуру путем вызова CWnd::GetCurrentMessage. Затем он сравнивает HWND кнопку с элементами и MSG::lParamMSG::hwnd элементами, чтобы определить, была ли кнопка источником команды.

`CMFCToolBar::IsLocked`

Определяет, заблокирована ли панель инструментов.

BOOL IsLocked() const;

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

TRUE Значение , если панель инструментов заблокирована; FALSEв противном случае .

Замечания

Этот метод возвращает, TRUE когда пользователь не может выполнять такие задачи настройки, как кнопки панели инструментов для перепозиции.

Заблокированные панели инструментов используют отдельные списки изображений. Дополнительные сведения об этих списках изображений см. в разделе CMFCToolBar::LoadBitmapEx.

`CMFCToolBar::IsOneRowWithSibling`

Определяет, размещается ли панель инструментов и ее братской панели инструментов в одной строке.

BOOL IsOneRowWithSibling();

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

TRUE Значение , если панель инструментов и его брат расположены в одной строке; в противном случае FALSE.

Замечания

Метод CMFCCustomizeButton::CreatePopupMenu вызывает этот метод, чтобы определить, как отобразить всплывающее меню "Настройка ". Если этот метод возвращается TRUE, платформа отображает кнопку "Показать кнопки" на одной строке . В противном случае платформа отображает кнопку "Показать кнопки" на двух строках .

Использование этого метода обычно не требуется. Чтобы включить кнопки "Показать" в одной строке или "Показать кнопки" на двух строках , вызовите вызов CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::IsResourceChanged`

virtual BOOL IsResourceChanged() const;

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

Замечания

`CMFCToolBar::IsSibling`

BOOL IsSibling();

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

Замечания

`CMFCToolBar::IsUserDefined`

Указывает, определена ли панель инструментов пользователем.

BOOL IsUserDefined() const;

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

TRUE Значение , если панель инструментов была создана пользователем; в противном случае FALSE.

`CMFCToolBar::LoadBitmap`

Загружает изображения значков панели инструментов из ресурсов приложения.

virtual BOOL LoadBitmap(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Параметры

uiResID
[in] Идентификатор ресурса растрового изображения, который ссылается на изображения горячей панели инструментов.

uiColdResID
[in] Идентификатор ресурса растрового изображения, который ссылается на изображения холодной панели инструментов.

uiMenuResID
[in] Идентификатор ресурса растрового изображения, который ссылается на обычные изображения меню.

bLocked
[in] TRUE блокировка панели инструментов; в противном случае FALSE.

uiDisabledResID
[in] Идентификатор ресурса растрового изображения, который ссылается на отключенные изображения панели инструментов.

uiMenuDisabledResID
[in] Идентификатор ресурса растрового изображения, который ссылается на отключенные изображения меню.

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

Ненулевое значение, если метод выполнен успешно; в противном случае — 0.

Замечания

Метод CMFCToolBar::LoadToolBarEx вызывает этот метод для загрузки изображений, связанных с панелью инструментов. Переопределите этот метод для выполнения пользовательской загрузки графических ресурсов.

Вызовите метод LoadBitmapEx , чтобы загрузить дополнительные изображения после создания панели инструментов.

`CMFCToolBar::LoadBitmapEx`

virtual BOOL LoadBitmapEx(
    CMFCToolBarInfo& params,
    BOOL bLocked = FALSE);

Параметры

[входной] params
[входной] bLocked\

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

Замечания

`CMFCToolBar::LoadLargeIconsState`

static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL);

Параметры

[входной] lpszProfileName\

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

Замечания

`CMFCToolBar::LoadParameters`

Загружает параметры глобальной панели инструментов из реестра Windows.

static BOOL LoadParameters(LPCTSTR lpszProfileName=NULL);

Параметры

lpszProfileName
[in] Указывает относительный путь к разделу реестра Windows.

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

Ненулевое значение, если метод выполнен успешно; в противном случае — 0.

Замечания

Этот метод загружает глобальные параметры, такие как тип анимации меню, стиль тени меню и отображение больших значков из реестра Windows.

Метод CWinAppEx::LoadState вызывает этот метод как часть процесса инициализации приложения.

`CMFCToolBar::LoadState`

Загружает сведения о состоянии панели инструментов из реестра Windows.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Параметры

lpszProfileName
[in] Указывает относительный путь к разделу реестра Windows.

nIndex
[in] Указывает идентификатор элемента управления панели инструментов.

uiID
[in] Указывает идентификатор ресурса панели инструментов.

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

Ненулевое значение, если метод выполнен успешно; в противном случае — 0.

Замечания

Платформа вызывает этот метод как часть процесса инициализации приложения. Дополнительные сведения см. в разделе CWinAppEx::LoadState.

`CMFCToolBar::LoadToolBar`

Загружает панель инструментов из ресурсов приложения.

virtual BOOL LoadToolBar(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0,
    UINT uiHotResID=0);

Параметры

uiResID
[in] Идентификатор ресурса панели инструментов.

uiMenuResID
[in] Идентификатор ресурса растрового изображения, который ссылается на обычные изображения меню.

bLocked
[in] Логическое значение, указывающее, заблокирована ли панель инструментов. Если этот параметр задан TRUE, панель инструментов заблокирована. В противном случае панель инструментов не заблокирована.

uiHotResID
[in] Идентификатор ресурса растрового изображения, который ссылается на изображения горячей панели инструментов.

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

Ненулевое значение, если метод выполнен успешно; в противном случае — 0.

Замечания

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

Пример

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

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

`CMFCToolBar::LoadToolBarEx`

Загружает панель инструментов из ресурсов приложения с помощью вспомогательного CMFCToolBarInfo класса, чтобы приложение использовало большие изображения.

virtual BOOL LoadToolBarEx(
    UINT uiToolbarResID,
    CMFCToolBarInfo& params,
    BOOL bLocked=FALSE);

Параметры

uiToolbarResID
[in] Идентификатор ресурса панели инструментов.

params
[in] Ссылка на CMFCToolBarInfo объект, содержащий идентификаторы ресурсов для изображений панели инструментов.

bLocked
[in] Логическое значение, указывающее, заблокирована ли панель инструментов. Если этот параметр задан TRUE, панель инструментов заблокирована. В противном случае панель инструментов не заблокирована.

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

Ненулевое значение, если метод выполнен успешно; в противном случае — 0.

Замечания

Вызовите этот метод для загрузки изображений панели инструментов из ресурсов приложения.

`CMFCToolBar::m_dblLargeImageRatio`

Задает соотношение между измерением (высота или ширина) больших изображений и измерением регулярных изображений.

AFX_IMPORT_DATA static double m_dblLargeImageRatio;

Замечания

Значение по умолчанию — 2. Это значение можно изменить, чтобы сделать изображения больших панелей инструментов большими или меньшими.

Платформа использует этот элемент данных, если не указать набор больших изображений. Например, если вы предоставляете только набор небольших изображений с размером 16x16 и хотите, чтобы большие изображения имели размер 24x24, задайте для этого элемента данных значение 1,5.

`CMFCToolBar::NextMenu`

virtual BOOL NextMenu();

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

Замечания

`CMFCToolBar::OnBeforeRemoveButton`

virtual BOOL OnBeforeRemoveButton(
    CMFCToolBarButton* pButton,
    DROPEFFECT dropEffect);

Параметры

pButton
[in] Неиспользуемые.

dropEffect
[in] Неиспользуемые.

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

Замечания

`CMFCToolBar::OnChangeHot`

Вызывается платформой, когда пользователь выбирает кнопку на панели инструментов.

virtual void OnChangeHot(int iHot);

Параметры

iHot
[in] Указывает индекс выбранной кнопки панели инструментов; или -1, если кнопка панели инструментов не выбрана.

Замечания

Переопределите этот метод для обработки уведомлений о том, что пользователь выбрал кнопку на панели инструментов.

`CMFCToolBar::OnChangeVisualManager`

virtual void OnChangeVisualManager();

Замечания

`CMFCToolBar::OnFillBackground`

Вызывается платформой для CBasePane::DoPaint заполнения фона панели инструментов.

virtual void OnFillBackground(CDC* pDC);

Параметры

pDC
[in] Указатель на контекст устройства.

Замечания

CMFCToolBar::DoPaint вызывает этот метод при заполнении фона панели инструментов. Реализация по умолчанию не выполняет никаких действий.

Переопределите этот метод для рисования пользовательского фона в производных классах.

`CMFCToolBar::OnGlobalFontsChanged`

virtual void OnGlobalFontsChanged();

Замечания

`CMFCToolBar::OnReset`

Восстанавливает панель инструментов в исходном состоянии.

virtual void OnReset();

Замечания

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

Реализация по умолчанию не выполняет никаких действий. Переопределите OnReset класс, производный от CMFCToolBar того, когда на панели инструментов есть фиктивные кнопки, которые должны быть заменены при возврате панели инструментов в исходное состояние.

`CMFCToolBar::OnSetAccData`

virtual BOOL OnSetAccData(long lVal);

Параметры

[входной] lVal\

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

Замечания

`CMFCToolBar::OnSetDefaultButtonText`

Восстанавливает текст кнопки панели инструментов до состояния по умолчанию.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Параметры

pButton
[in] Указывает на кнопку, текст которой задается.

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

TRUE Значение ifthe text было успешно восстановлено; в противном случае FALSE.

Замечания

Переопределите этот метод для обработки уведомлений о том, что текст кнопки панели инструментов изменяется на его значение по умолчанию.

Реализация по умолчанию загружает текст кнопки из ресурсов приложения.

`CMFCToolBar::OnUserToolTip`

Вызывается платформой при отображении подсказки для кнопки.

virtual BOOL OnUserToolTip(
    CMFCToolBarButton* pButton,
    CString& strTTText) const;

Параметры

pButton
[in] Указывает на кнопку панели инструментов, для которой должна отображаться подсказка.

strTTText
[out] Ссылка на CString объект, получающий текст подсказки.

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

TRUE Значение , если strTTText заполнено текстом подсказки; в противном случае FALSE.

Замечания

Платформа вызывает этот метод, когда подсказка для кнопки панели инструментов будет отображаться. Если OnUserToolTip возвращается TRUE, платформа отображает подсказку, содержащую текст, возвращаемый OnUserToolTip в strTTText. В противном случае подсказка содержит текст кнопки.

Переопределите OnUserToolTip , чтобы настроить подсказки инструментов кнопок панели инструментов. Вызовы CMFCToolBar::OnUserToolTip реализации по умолчанию для получения текста подсказки.

`CMFCToolBar::PrevMenu`

virtual BOOL PrevMenu();

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

Замечания

`CMFCToolBar::ProcessCommand`

WM_COMMAND Отправляет сообщение в окно, которое владеет панелью инструментов.

BOOL ProcessCommand(CMFCToolBarButton* pButton);

Параметры

pButton
[in] Указатель на кнопку на панели инструментов.

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

Этот метод всегда должен возвращать TRUE. MFC использует FALSE значения внутри системы.

Замечания

Этот метод отправляет WM_COMMAND сообщение в окно, которое владеет панелью инструментов, вызывая CWnd::PostMessage и передав идентификатор команды указанной кнопки в качестве wParam параметра.

ON_COMMAND Используйте макрос для сопоставления WM_COMMAND сообщения с функцией-членом.

`CMFCToolBar::RemoveAllButtons`

Удаляет все кнопки и разделители из панели инструментов.

virtual void RemoveAllButtons();

Замечания

Платформа вызывает этот метод при повторном создании или уничтожении панели инструментов.

`CMFCToolBar::RemoveButton`

Удаляет на панели инструментов кнопку с указанным индексом.

virtual BOOL RemoveButton(int iIndex);

Параметры

iIndex
[in] Указывает отсчитываемый от нуля индекс кнопки для удаления.

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

TRUE Значение , если метод выполнен успешно, или FALSE если указанный индекс недопустим или индекс ссылается на кнопку "Настройка ".

Замечания

Этот метод обновляет дополнительные атрибуты панели инструментов, затронутые удалением кнопки. Например, этот метод удаляет ненессные разделители из панели инструментов и перестраивает таблицу сочетаний клавиш.

Дополнительные сведения о кнопке "Настройка " см. в разделе CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::RemoveStateFromRegistry`

Удаляет сведения о состоянии панели инструментов из реестра Windows.

virtual BOOL RemoveStateFromRegistry(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Параметры

lpszProfileName
[in] Указывает раздел реестра, в котором находятся сведения о состоянии.

nIndex
[in] Идентификатор элемента управления панели инструментов.

uiID
[in] Идентификатор ресурса панели инструментов. Если этот параметр равен -1, этот метод использует CWnd::GetDlgCtrlID метод для получения идентификатора ресурса.

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

Ненулевое значение, если метод выполнен успешно; в противном случае — 0.

Замечания

Платформа вызывает этот метод при удалении определяемой пользователем панели инструментов.

Переопределите этот метод при хранении дополнительных сведений о состоянии в реестре Windows.

`CMFCToolBar::ReplaceButton`

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

int ReplaceButton(
    UINT uiCmd,
    const CMFCToolBarButton& button,
    BOOL bAll=FALSE);

Параметры

uiCmd
[in] Идентификатор команды для замены кнопки.

button
[in] Ссылка на CMFCToolBarButton вставку.

bAll
[in] Логическое значение, указывающее, следует ли заменить все кнопки с идентификатором команды, заданным uiCmd. Если этот параметр задан TRUE, заменяются все кнопки с указанным идентификатором команды. В противном случае первая кнопка заменена.

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

Количество заменяемых кнопок. Этот метод возвращает значение 0, если кнопка с указанным идентификатором команды не существует на панели инструментов.

Замечания

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

Пример

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

CMFCToolBar m_wndToolBar;

// CMenu menuHistory
// CString str
m_wndToolBar.ReplaceButton(ID_GO_BACK,
                           CMFCToolBarMenuButton(ID_GO_BACK, menuHistory,
                                                 GetCmdMgr()->GetCmdImage(ID_GO_BACK), str));

`CMFCToolBar::ResetAll`

Восстанавливает все панели инструментов в исходные состояния.

static void __stdcall ResetAll();

Замечания

Этот метод вызывает CMFCToolBar::RestoreOriginalState метод на каждой панели инструментов в приложении, которое можно восстановить. Он использует CMFCToolBar::CanBeRestored метод для определения возможности восстановления панели инструментов.

`CMFCToolBar::ResetAllImages`

Очищает все коллекции образов панели инструментов в приложении.

static void __stdcall ResetAllImages();

Замечания

Этот метод очищает коллекции изображений, инициализированные методами CMFCToolBar::LoadToolBar и CMFCToolBar::LoadBitmap методами.

`CMFCToolBar::ResetImages`

virtual void ResetImages();

Замечания

`CMFCToolBar::RestoreFocus`

virtual void RestoreFocus();

Замечания

`CMFCToolBar::RestoreOriginalState`

Восстанавливает первоначальное состояние панели инструментов.

virtual BOOL RestoreOriginalState();

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

TRUE Значение , если метод завершается успешно, или FALSE если метод завершается ошибкой или панель инструментов определяется пользователем.

Замечания

Этот метод загружает панель инструментов из файла ресурсов с помощью CMFCToolBar::LoadToolBar метода.

Платформа вызывает этот метод, когда пользователь выбирает кнопку "Сброс всех" на странице "Панели инструментов " диалогового окна настройки.

`CMFCToolBar::SaveParameters`

static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL);

Параметры

[входной] lpszProfileName\

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

Замечания

`CMFCToolBar::SaveState`

Сохраняет сведения о состоянии панели инструментов в реестре Windows.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Параметры

lpszProfileName
[in] Указывает относительный путь к разделу реестра Windows.

nIndex
[in] Идентификатор элемента управления панели инструментов.

uiID
[in] Идентификатор ресурса панели инструментов.

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

Ненулевое значение, если метод выполнен успешно; в противном случае — 0.

Замечания

Платформа вызывает этот метод при сохранении состояния приложения в реестре. Дополнительные сведения см. в разделе CWinAppEx::SaveState.

`CMFCToolBar::SetBasicCommands`

Задает список команд, которые всегда отображаются при открытии пользователем меню.

static void __stdcall SetBasicCommands(CList<UINT,UINT>& lstCommands);

Параметры

lstCommands
[in] Ссылка на CList объект, содержащий коллекцию команд.

Замечания

CMFCToolBar::AddBasicCommand Используйте метод, чтобы добавить команду в список основных команд. CMFCToolBar::GetBasicCommands Используйте метод для получения списка основных команд, используемых приложением.

Пример Обозреватель см. в примере, использующего этот метод.

`CMFCToolBar::SetButtonInfo`

Задает идентификатор команды, стиль и идентификатор изображения кнопки панели инструментов.

void SetButtonInfo(
    int nIndex,
    UINT nID,
    UINT nStyle,
    int iImage);

Параметры

nIndex
[in] Отсчитываемый от нуля индекс кнопки, свойства которой задаются.

nID
[in] Идентификатор команды кнопки.

nStyle
[in] Стиль кнопки. См. статью "Стили элементов управления ToolBar" для списка доступных стилей кнопок панели инструментов.

iImage
[in] Отсчитываемый от нуля индекс изображения кнопки (то есть индекс в коллекции изображений панели инструментов).

Замечания

Вызовите этот метод, чтобы задать свойства кнопки панели инструментов.

В сборках отладки этот метод создает сбой утверждения, если индекс, указанный недопустимым nIndex .

CMFCToolBar::SetButtonStyle Вызовите метод, чтобы задать только стиль кнопки.

`CMFCToolBar::SetButtons`

Задает кнопки для панели инструментов.

virtual BOOL SetButtons(
    const UINT* lpIDArray,
    int nIDCount,
    BOOL bRemapImages=TRUE);

Параметры

lpIDArray
[in] Указатель на массив идентификаторов команд для вставки кнопок.

nIDCount
[in] Количество элементов в lpIDArray.

bRemapImages
[in] Логическое значение, указывающее, следует ли связывать существующие изображения кнопок с вставленными кнопками. Если этот параметр задан TRUE, образы переназначаются.

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

Ненулевое значение, если метод выполнен успешно; в противном случае — 0.

Замечания

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

Этот метод добавляет кнопку "Настройка" на панель инструментов и отправляет AFX_WM_RESETTOOLBAR сообщение в родительское окно панели инструментов. Дополнительные сведения о кнопке "Настройка " см. в разделе CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::SetButtonStyle`

Задает стиль кнопки панели инструментов по указанному индексу.

virtual void SetButtonStyle(
    int nIndex,
    UINT nStyle);

Параметры

nIndex
[in] Отсчитываемый от нуля индекс кнопки панели инструментов, стиль которого необходимо задать.

Замечания

Этот метод удаляет TBBS_PRESSED стиль, если nStyleTBBS_DISABLED пользователь не может выбрать отключенную кнопку.

`CMFCToolBar::SetButtonText`

Задает текстовую метку кнопки панели инструментов.

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

Параметры

nIndex
[in] Индекс кнопки панели инструментов.

lpszText
[in] Текстовая метка кнопки панели инструментов. должен иметь значение, отличное от NULL.

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

TRUE Значение , если метод выполнен успешно; в противном случае FALSE.

Замечания

Этот метод возвращает, FALSE если указанный индекс не ссылается на допустимую кнопку панели инструментов.

`CMFCToolBar::SetCommandUsageOptions`

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

static BOOL SetCommandUsageOptions(
    UINT nStartCount,
    UINT nMinUsagePercentage=5);

Параметры

nStartCount
[in] Указывает количество раз, когда команды должны выполняться, прежде чем платформа отображает только основные и недавно используемые команды.

nMinUsagePercentage
[in] Процент времени выполнения команды, которую следует считать недавно используемой командой.

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

FALSE Значение , если nMinUsagePercentage равно или больше 100; в противном случае TRUE.

Замечания

Вызовите этот метод, чтобы настроить алгоритм, используемый платформой, чтобы определить, как отображаются основные и недавно используемые элементы меню. Дополнительные сведения об основных командах см. в разделе CMFCToolBar::AddBasicCommand.

Этот класс использует CMFCCmdUsageCount класс для отслеживания количества команд. Дополнительные сведения об этом классе см. в разделе CMFCCmdUsageCount "Класс".

`CMFCToolBar::SetCustomizeMode`

Включает или отключает режим настройки для всех панелей инструментов в приложении.

static BOOL __stdcall SetCustomizeMode(BOOL bSet=TRUE);

Параметры

bSet
[in] Логическое значение, указывающее, следует ли включить или отключить режим настройки. Задайте этот параметр, чтобы TRUE включить режим настройки или FALSE отключить его.

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

TRUE При вызове этого метода изменяется режим настройки; в противном случае FALSE.

Замечания

Этот метод настраивает макет и перерисовывает каждую панель инструментов в приложении. CMFCToolBar::IsCustomizeMode Вызовите метод, чтобы определить, находится ли приложение в режиме настройки,

`CMFCToolBar::SetGrayDisabledButtons`

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

void SetGrayDisabledButtons(BOOL bGrayDisabledButtons);

Параметры

bGrayDisabledButtons
[in] Логическое значение, указывающее, как отображать недоступные кнопки. Если этот параметр задан TRUE, платформа смустит кнопки. В противном случае платформа использует коллекцию изображений, недоступных для кнопки.

Замечания

По умолчанию недоступные кнопки неактивны.

`CMFCToolBar::SetHeight`

Задает высоту панели инструментов.

void SetHeight(int cyHeight);

Параметры

cyHeight
[in] Высота панели инструментов в пикселях.

Замечания

Этот метод перерисовывает панель инструментов после установки высоты.

`CMFCToolBar::SetHelpMode`

static void __stdcall SetHelpMode(BOOL bOn = TRUE);

Параметры

[входной] bOn\

Замечания

`CMFCToolBar::SetHot`

BOOL SetHot(CMFCToolBarButton* pMenuButton);

Параметры

[входной] pMenuButton\

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

Замечания

`CMFCToolBar::SetHotBorder`

Указывает, являются ли кнопки панели инструментов горячим отслеживанием.

void SetHotBorder(BOOL bShowHotBorder);

Параметры

bShowHotBorder
[in] Логическое значение, указывающее, следует ли использовать кнопки панели инструментов горячего отслеживания. Если этот параметр задан TRUE, панель инструментов отслеживает ее кнопки. В противном случае панель инструментов не отслеживает ее кнопки.

Замечания

Если кнопка горячего отслеживания, платформа выделяет кнопку при перемещении мыши по нему. По умолчанию каждая панель инструментов отслеживает свои кнопки.

CMFCToolBar::GetHotBorder Вызовите метод, чтобы определить, отслеживает ли панель инструментов ее кнопки.

`CMFCToolBar::SetHotTextColor`

Задает цвет текста для кнопок горячей панели инструментов.

static void SetHotTextColor(COLORREF clrText);

Параметры

clrText
[in] Задает цвет текста для кнопок панели инструментов, которые находятся в режиме горячей отслеживания.

Замечания

Дополнительные сведения о кнопках панели инструментов с горячим отслеживанием см. в разделе CMFCToolBar::GetHotBorder и CMFCToolBar::SetHotBorder.

`CMFCToolBar::SetIgnoreSetText`

void SetIgnoreSetText(BOOL bValue);

Параметры

[входной] bValue\

Замечания

`CMFCToolBar::SetLargeIcons`

Указывает, отображаются ли кнопки панели инструментов большими значками.

static void SetLargeIcons(BOOL bLargeIcons=TRUE);

Параметры

bLargeIcons
[in] Логическое значение, указывающее, какие значки следует использовать. Если этот параметр задан TRUE, платформа отображает большие значки. В противном случае платформа отображает обычные значки.

Замечания

Платформа вызывает этот метод, когда пользователь изменяет состояние поля "Большие значки" проверка на вкладке "Параметры" диалогового окна "Настройка". Этот метод изменяет размер всех панелей инструментов в приложении.

По умолчанию платформа отображает обычные значки.

Дополнительные сведения о диалоговом окне "Настройка" см. в разделе CMFCToolBarsCustomizeDialog "Класс".

`CMFCToolBar::SetLockedSizes`

Задает размеры заблокированных кнопок и заблокированных изображений на панели инструментов.

void SetLockedSizes(
    SIZE sizeButton,
    SIZE sizeImage,
    BOOL bDontScale = FALSE);

Параметры

sizeButton
[in] Задает размер заблокированных кнопок панели инструментов.

sizeImage
[in] Задает размер заблокированных изображений панели инструментов.

bDontScale
Указывает, следует ли масштабировать или не блокировать изображения панели инструментов в режиме высокого уровня DPI.

Замечания

Размер заблокированных кнопок по умолчанию составляет 23x22 пикселя. Размер заблокированных изображений по умолчанию составляет 16x15 пикселей.

CMFCToolBar::GetLockedImageSize Вызовите метод, чтобы получить размер заблокированных изображений. CMFCToolBar::GetButtonSize Вызовите метод, чтобы получить размер заблокированных кнопок панели инструментов.

`CMFCToolBar::SetMaskMode`

void SetMaskMode(BOOL bMasked);

Параметры

[входной] bMasked\

Замечания

`CMFCToolBar::SetMenuSizes`

Задает размер кнопок меню панели инструментов и их изображений.

static void __stdcall SetMenuSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Параметры

sizeButton
[in] Задает размер кнопок панели инструментов в пикселях.

sizeImage
[in] Задает размер изображений панели инструментов в пикселях.

Замечания

По умолчанию кнопки меню и их изображения имеют неопределенный размер.

CMFCToolBar::GetMenuButtonSize Вызовите метод, чтобы определить размер кнопок меню и CMFCToolBar::GetMenuImageSize метод, чтобы определить размер изображений кнопок меню.

Примеры использования этого метода см. в примерах IEDemo и MSMoneyDemo.

`CMFCToolBar::SetNonPermittedCommands`

Задает список команд, которые не могут выполняться пользователем.

static void SetNonPermittedCommands(CList<UINT,UINT>& lstCommands);

Параметры

lstCommands
[in] Ссылка на CList объект, содержащий команды, которые не могут выполняться пользователем.

Замечания

Вызовите этот метод, чтобы запретить пользователю выбирать определенные команды. Например, может потребоваться запретить пользователю выбирать определенные команды по соображениям безопасности. Примеры использования этого метода см. в примерах MDITabsDemo и MenuSubSet.

Этот метод очищает предыдущий список не разрешенных команд. По умолчанию список не разрешенных команд пуст.

`CMFCToolBar::SetOneRowWithSibling`

Размещает панель инструментов и его брат в одной строке.

void SetOneRowWithSibling();

Замечания

Платформа вызывает этот метод, когда пользователь выбирает кнопку "Показать кнопки" на одной строке .

CMFCToolBar::SetSiblingToolBar Вызовите метод, чтобы включить кнопки "Показать" в одной строке или "Показать кнопки" на двух строках. При вызове CMFCToolBar::SetSiblingToolBar этой панели инструментов панель инструментов с братом перемещается в строку этой панели инструментов. В противном случае эта панель инструментов перемещается в строку брата.

Платформа вызывает CMFCToolBar::SetTwoRowsWithSibling метод, когда пользователь нажимает кнопку "Показать кнопки" на двух строках .

`CMFCToolBar::SetOrigButtons`

void SetOrigButtons(const CObList& lstOrigButtons);

Параметры

[входной] lstOrigButtons\

Замечания

`CMFCToolBar::SetPermament`

Указывает, может ли пользователь закрыть панель инструментов.

void SetPermament(BOOL bPermament=TRUE);

Параметры

bPermament
[in] Логическое значение, указывающее, может ли пользователь закрыть панель инструментов. Если этот параметр задан TRUE, пользователь не может закрыть панель инструментов. В противном случае пользователь может закрыть панель инструментов.

Замечания

По умолчанию пользователь может закрыть каждую панель инструментов.

CMFCToolBar::CanBeClosed Вызовите метод, чтобы определить, может ли пользователь закрыть панель инструментов.

`CMFCToolBar::SetRouteCommandsViaFrame`

Указывает, отправляет ли родительский кадр или владелец команды на панель инструментов.

void SetRouteCommandsViaFrame(BOOL bValue);

Параметры

bValue
[in] Если этот параметр задан TRUE, родительский кадр отправляет команды на панель инструментов. В противном случае владелец отправляет команды на панель инструментов.

Замечания

По умолчанию родительский кадр отправляет команды на панель инструментов. CMFCToolBar::GetRouteCommandsViaFrame Вызовите метод, чтобы определить, отправляет ли родительский кадр или владелец команды на панель инструментов.

`CMFCToolBar::SetShowTooltips`

Указывает, отображает ли платформа подсказки инструментов.

static void SetShowTooltips(BOOL bValue);

Параметры

bValue
[in] Если этот параметр задан TRUE, платформа отображает подсказки инструментов. В противном случае платформа скрывает подсказки инструментов.

Замечания

По умолчанию платформа показывает подсказки по инструменту.

CMFCToolBar::GetShowTooltips Вызовите метод, чтобы определить, отображает ли платформа подсказки.

`CMFCToolBar::SetSiblingToolBar`

Указывает одноуровневый элемент панели инструментов.

void SetSiblingToolBar(CMFCToolBar* pBrotherToolbar);

Параметры

pBrotherToolbar
[in] Указатель на панель инструментов брата.

Замечания

Этот метод включает кнопки "Показать" в одной строке или "Показать кнопки" на двух строках , отображаемые при отображении всплывающего меню "Настройка ". Вызовите этот метод, если вы хотите разрешить пользователю указать, отображаются ли связанные панели инструментов в одной строке или в разных строках.

Вызовите этот метод после включения кнопки "Настройка ", которая отображается на панели инструментов. Чтобы включить кнопку "Настройка" , вызовите CMFCToolBar::EnableCustomizeButton метод.

Чтобы получить одноуровневый элемент панели инструментов, вызовите .CMFCToolBar::GetSiblingToolBar

`CMFCToolBar::SetSizes`

Задает размеры кнопок и изображений на всех панелях инструментов.

static void __stdcall SetSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Параметры

sizeButton
[in] Размер кнопок панели инструментов в пикселях.

sizeImage
[in] Размер изображений кнопки панели инструментов в пикселях.

Замечания

Размер кнопок панели инструментов по умолчанию составляет 23x22 пикселя. Размер изображений кнопки панели инструментов по умолчанию составляет 16x15 пикселей.

CMFCToolBar::GetImageSize Вызовите метод, чтобы получить размер изображений кнопок панели инструментов. CMFCToolBar::GetButtonSize Вызовите метод, чтобы получить размер кнопок панели инструментов.

`CMFCToolBar::SetToolBarBtnText`

Указывает свойства кнопки на панели инструментов.

void SetToolBarBtnText(
    UINT nBtnIndex,
    LPCTSTR szText=NULL,
    BOOL bShowText=TRUE,
    BOOL bShowImage=TRUE);

Параметры

nBtnIndex
[in] Отсчитываемый от нуля индекс кнопки панели инструментов в списке кнопок панели инструментов.

szText
[in] Указывает текстовую метку кнопки панели инструментов.

bShowText
[in] Если этот параметр задан TRUE, платформа отображает текстовую метку. В противном случае платформа скрывает текстовую метку.

bShowImage
[in] Если этот параметр задан TRUE, платформа отображает изображение кнопки панели инструментов. В противном случае платформа скрывает изображение кнопки панели инструментов.

Замечания

По умолчанию платформа отображает изображения кнопок панели инструментов, но не отображает текстовую метку кнопок панели инструментов.

В сборках отладки этот метод создает сбой утверждения, если nBtnIndex не ссылается на действительную кнопку панели инструментов или кнопка панели инструментов является разделителем.

`CMFCToolBar::SetTwoRowsWithSibling`

Позиционирует панель инструментов и его одноуровневый элемент в отдельных строках.

void SetTwoRowsWithSibling();

Замечания

Платформа вызывает этот метод, когда пользователь нажимает кнопку "Показать кнопки" на двух строках .

CMFCToolBar::SetSiblingToolBar Вызовите метод, чтобы включить кнопки "Показать" в одной строке или "Показать кнопки" на двух строках. При вызове CMFCToolBar::SetSiblingToolBar этой панели инструментов панель инструментов с братом перемещается в отдельную строку. В противном случае эта панель инструментов перемещается в отдельную строку.

Платформа вызывает CMFCToolBar::SetOneRowWithSibling метод, когда пользователь выбирает кнопку "Показать кнопки" на одной строке .

`CMFCToolBar::SetUserImages`

Задает коллекцию пользовательских изображений в приложении.

static BOOL SetUserImages(CMFCToolBarImages* pUserImages);

Параметры

pUserImages
[in] Указатель на коллекцию пользовательских изображений.

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

Ненулевое значение, если метод выполнен успешно; В противном случае значение 0, если указанный CMFCToolBarImages объект недействителен или имеет размер изображения, который отличается от размера изображения по умолчанию панели инструментов.

Замечания

Платформа использует пользовательские изображения для рисования кнопок панели инструментов, настроенных пользователем. Список изображений, указанный pUserImages в приложении, предоставляется всем панелям инструментов.

Этот метод создает сбой утверждения в сборках отладки, если указанный CMFCToolBarImages объект недопустим или имеет размер изображения, который отличается от размера изображения по умолчанию на панели инструментов.

Примеры OutlookDemo, ToolTipDemo и VisualStudioDemo используют этот метод для задания глобальной коллекции пользовательских изображений. Они загружают файл с именем UserImages.bmp, расположенный в рабочем каталоге приложения.

Вызовите метод CMFCToolBar::GetUserImages, чтобы получить коллекцию пользовательских изображений в приложении.

`CMFCToolBar::StretchPane`

Растягивает панель инструментов по вертикали или по горизонтали и при необходимости перемещает кнопки.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Параметры

nLength
[in] Объем в пикселях, по которому нужно растянуть панель.

bVert
[in] Если TRUE, растягивает область по вертикали. Если FALSE, растягивает область по горизонтали.

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

Объект CSize , указывающий размер клиентской области панели инструментов.

Замечания

Этот метод вызывает CMFCToolBar::WrapToolBar изменение положения кнопок на растянутой панели инструментов.

Возвращаемое значение определяется вызовом CMFCToolBar::CalcSize.

`CMFCToolBar::TranslateChar`

Выполняет команду кнопки, если указанный код ключа соответствует допустимому сочетанию клавиш.

virtual BOOL TranslateChar(UINT nChar);

Параметры

nChar
[in] Задает код виртуального ключа. Список стандартных кодов виртуальных ключей см. в разделе Winuser.h

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

FALSE Значение , если указанный код ключа является неизменяемым или не соответствует допустимому сочетанию клавиш; TRUE Значение возвращаемого значения, если указанный код ключа соответствует параметру раскрывающегося меню; в противном случае возвращается значение CMFCToolBar::ProcessCommand.

Замечания

Платформа вызывает этот метод, когда клавиша нажимается вместе с клавишей ALT .

`CMFCToolBar::UpdateButton`

Обновления состояние указанной кнопки.

void UpdateButton(int nIndex);

Параметры

nIndex
[in] Указывает отсчитываемый от нуля индекс кнопки для обновления.

Замечания

`CMFCToolBar::WrapToolBar`

Кнопки панели инструментов перепозиции в заданных измерениях.

int WrapToolBar(
    int nWidth,
    int nHeight = 32767,
    CDC* pDC = NULL,
    int nColumnWidth = -1,
    int nRowHeight = -1);

Параметры

nWidth
[in] Максимальная ширина панели инструментов.

nHeight
[in] Максимальная высота панели инструментов. Не используется, если панель инструментов плавает.

pDC
[in] Указатель на контекст устройства. Если NULLиспользуется контекст устройства для панели инструментов.

nColumnWidth
[in] Ширина кнопки. Если значение -1, используется текущая ширина.

[in] mnRowHeight Высота кнопки. Если значение -1, используется текущая высота.

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

Количество строк кнопок на панели инструментов.

Замечания

При необходимости этот метод перемещает кнопки на панели инструментов, обтекая кнопки на дополнительные строки.

`CMFCToolBar::m_bDontScaleImages`

Указывает, следует ли масштабировать изображения панели инструментов в режиме высокого уровня DPI. Установите для TRUE предотвращения масштабирования изображений, если размер изображения не соответствует размеру кнопки.

AFX_IMPORT_DATA static BOOL m_bDontScaleImages;

См. также

Диаграмма иерархии
Классы
CMFCMenuBar Класса
CMFCPopupMenuBar Класса
CMFCDropDownToolBar Класса
Пошаговое руководство. Размещение элементов управления на панели инструментов

Класс CMFCToolBar

Синтаксис

Участники

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

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

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

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

Замечания

Пример

Требования

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

CMFCToolBar::AddBasicCommand

Параметры

Замечания

CMFCToolBar::AddCommandUsage

Параметры

Замечания

CMFCToolBar::AddToolBarForImageCollection

Параметры

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

Замечания

CMFCToolBar::AdjustLayout

Замечания

CMFCToolBar::AdjustSize

Замечания

CMFCToolBar::AllowChangeTextLabels

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

Замечания

CMFCToolBar::AllowShowOnList

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

Замечания

CMFCToolBar::AreTextLabels

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

Замечания

CMFCToolBar::AutoGrayInactiveImages

Параметры

Замечания

CMFCToolBar::ButtonToIndex

Параметры

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

CMFCToolBar::CalcFixedLayout

Параметры

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

Замечания

CMFCToolBar::CalcMaxButtonHeight

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

Замечания

CMFCToolBar::CalcSize

Параметры

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

Замечания

CMFCToolBar::CanBeClosed

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

Замечания

CMFCToolBar::CanBeRestored

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

Замечания

CMFCToolBar::CanFocus

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

Замечания

CMFCToolBar::CanHandleSiblings

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

Замечания

CMFCToolBar::CleanUpImages

Замечания

CMFCToolBar::CleanUpLockedImages

Замечания

CMFCToolBar::CommandToIndex

Параметры

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

Замечания

CMFCToolBar::Create

Параметры

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

Замечания

CMFCToolBar::CreateEx

Параметры

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

Замечания

Пример

Класс `CMFCToolBar`

`CMFCToolBar::AddBasicCommand`

`CMFCToolBar::AddCommandUsage`

`CMFCToolBar::AddToolBarForImageCollection`

`CMFCToolBar::AdjustLayout`

`CMFCToolBar::AdjustSize`

`CMFCToolBar::AllowChangeTextLabels`

`CMFCToolBar::AllowShowOnList`

`CMFCToolBar::AreTextLabels`

`CMFCToolBar::AutoGrayInactiveImages`

`CMFCToolBar::ButtonToIndex`

`CMFCToolBar::CalcFixedLayout`

`CMFCToolBar::CalcMaxButtonHeight`

`CMFCToolBar::CalcSize`

`CMFCToolBar::CanBeClosed`

`CMFCToolBar::CanBeRestored`

`CMFCToolBar::CanFocus`

`CMFCToolBar::CanHandleSiblings`

`CMFCToolBar::CleanUpImages`

`CMFCToolBar::CleanUpLockedImages`

`CMFCToolBar::CommandToIndex`

`CMFCToolBar::Create`

`CMFCToolBar::CreateEx`

`CMFCToolBar::Deactivate`

`CMFCToolBar::DoPaint`

`CMFCToolBar::DrawButton`

`CMFCToolBar::DrawSeparator`

`CMFCToolBar::EnableCustomizeButton`

`CMFCToolBar::EnableDocking`

`CMFCToolBar::EnableLargeIcons`

`CMFCToolBar::EnableQuickCustomization`

`CMFCToolBar::EnableReflections`

`CMFCToolBar::EnableTextLabels`

`CMFCToolBar::FromHandlePermanent`

`CMFCToolBar::GetAllButtons`

`CMFCToolBar::GetAllToolbars`

`CMFCToolBar::GetBasicCommands`

`CMFCToolBar::GetButton`

`CMFCToolBar::GetButtonInfo`

`CMFCToolBar::GetButtonSize`

`CMFCToolBar::GetButtonStyle`

`CMFCToolBar::GetButtonText`

`CMFCToolBar::GetColdImages`

`CMFCToolBar::GetColumnWidth`

`CMFCToolBar::GetCommandButtons`

`CMFCToolBar::GetCount`

`CMFCToolBar::GetCustomizeButton`