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


Класс CMFCToolBar

Класс 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 объект в приложение, выполните следующие действия.

  1. CMFCToolBar Добавьте объект в главное окно фрейма.

  2. При обработке сообщения WM_CREATE для главного окна фрейма вызовите CMFCToolBar::Create или CMFCToolBar::CreateEx создайте панель инструментов и укажите его стиль.

  3. Вызов 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

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

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

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, этот метод перерисовывает все панели инструментов.

Замечания

В противном случае bEnable TRUEплатформа используется 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.

Замечания

Этот метод создает панель управления и присоединяет ее к панели инструментов. Он создает панель управления с TBSTYLE_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 создания панели инструментов, которая напоминает панели инструментов, используемые Internet Explorer 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 указан допустимый идентификатор команды и bEnable TRUEесть, кнопка "Настройка" всегда отображается. Кнопка имеет небольшую стрелку вниз и открывает меню, содержащее команду. Эта команда использует текстовую метку, указанную в 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 и nStyle iImage значение -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;

Параметры

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

rString
[out] Текст метки кнопки панели инструментов.

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

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

Замечания

Вызов CMFCToolBar::SetButtonText или CMFCToolBar::SetToolBarBtnText установка текстовой метки.

CMFCToolBar::GetColdImages

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

static CMFCToolBarImages* GetColdImages();

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

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

Замечания

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

CMFCToolBar::GetColumnWidth

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

virtual int GetColumnWidth() 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);

Параметры

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

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

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

Замечания

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

CMFCToolBar::GetDisabledImages

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

static CMFCToolBarImages* __stdcall GetDisabledImages();

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

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

Замечания

Загрузите изображения с отключенной кнопкой панели инструментов с помощью CMFCToolBarEditBoxButton класса и CMFCToolBar::LoadBitmap методов.

CMFCToolBar::GetDisabledMenuImages

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

static CMFCToolBarImages* __stdcall GetDisabledMenuImages();

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

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

Замечания

Загрузите отключенные изображения с помощью CMFCToolBarEditBoxButton метода Class .

CMFCToolBar::GetDroppedDownMenu

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

CMFCToolBarMenuButton* GetDroppedDownMenu(int* pIndex = NULL) const;

Параметры

pIndex
[out] Получает индекс кнопки в коллекции кнопок панели инструментов.

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

Указатель на объект кнопки меню, отображающий его вложенное меню или NULL если меню не отображается.

Замечания

Если этот метод возвращает значение, отличное от NULL и pIndex не NULLявляется, значение, на которое указывает pIndex указатель, задается индекс кнопки меню в коллекции кнопок панели инструментов.

CMFCToolBar::GetGrayDisabledButtons

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

BOOL GetGrayDisabledButtons() const;

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

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

Замечания

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

CMFCToolBar::GetHighlightedButton

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

CMFCToolBarButton* GetHighlightedButton() const;

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

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

Замечания

Кнопка панели инструментов выделена, если она имеет фокус клавиатуры. Кнопка панели инструментов также выделена, если кнопки панели инструментов отслеживаются в этом приложении (дополнительные сведения, см CMFCToolBar::GetHotBorder . и CMFCToolBar::SetHotBorder) и мышь указывает на нее, если кнопка панели инструментов или элемент меню не имеют фокуса клавиатуры.

CMFCToolBar::GetHotBorder

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

BOOL GetHotBorder() const;

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

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

Замечания

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

CMFCToolBar::GetHotTextColor

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

static COLORREF GetHotTextColor();

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

Значение COLORREF , представляющее текущий выделенный цвет текста.

Замечания

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

CMFCToolBar::GetHwndLastFocus

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

HWND GetHwndLastFocus() const;

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

Дескриптор окна, не производный от CMFCBaseToolBar класса, который ранее имел фокус ввода, или NULL если такого окна нет.

Замечания

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

CMFCToolBar::GetIgnoreSetText

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

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 .

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

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

CMFCToolBar::GetLockedImages

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

CMFCToolBarImages* GetLockedImages();

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

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

Замечания

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

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

CMFCToolBar::GetLockedImageSize

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

CSize GetLockedImageSize() const;

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

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

Замечания

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

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

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

CMFCToolBar::GetLockedMenuImages

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

CMFCToolBarImages* GetLockedMenuImages();

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

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

Замечания

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

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

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::lParam MSG::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] Идентификатор ресурса панели инструментов.

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

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

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

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

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

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] Отсчитываемый от нуля индекс кнопки панели инструментов, стиль которого необходимо задать.

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

Замечания

Этот метод удаляет TBBS_PRESSED стиль, если nStyle TBBS_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] m nRowHeight Высота кнопки. Если значение -1, используется текущая высота.

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

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

Замечания

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

CMFCToolBar::m_bDontScaleImages

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

AFX_IMPORT_DATA static BOOL m_bDontScaleImages;

См. также

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