Класс CMFCToolBarButton

Статья
06/10/2015

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

class CMFCToolBarButton : public CObject

Члены

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

Имя	Описание
CMFCToolBarButton::CMFCToolBarButton	Создания и инициализации объект CMFCToolBarButton.
CMFCToolBarButton::~CMFCToolBarButton	Деструктор.

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

Имя	Описание
CMFCToolBarButton::CanBeDropped	Указывает, может ли пользователь изменить расположение кнопки на панели инструментов или меню во время настройки.
CMFCToolBarButton::CanBeStored	Определяет, является ли кнопка может быть сохранен.
CMFCToolBarButton::CanBeStretched	Указывает, может ли пользователь растянуть кнопка во время настройки.
CMFCToolBarButton::CompareWith	Сравнивает данный экземпляр с предоставленным объектом CMFCToolBarButton.
CMFCToolBarButton::CopyFrom	Копирует свойства другой кнопки панели инструментов с текущим кнопке.
CMFCToolBarButton::CreateFromOleData	Создает объект CMFCToolBarButton из предоставленного объекта COleDataObject.
CMFCToolBarButton::CreateObject	Используемый платформой, чтобы создать динамический экземпляр этого типа класса.
CMFCToolBarButton::EnableWindow	Включение или отключение ввода мыши и клавиатуры.
CMFCToolBarButton::ExportToMenuButton	Копии вставке СМС из кнопок панели инструментов в меню.
CMFCToolBarButton::GetClipboardFormat	Получает глобальный формат буфера обмена для приложения.
CMFCToolBarButton::GetHwnd	Получает дескриптор окна, который связан с кнопкой панели инструментов.
CMFCToolBarButton::GetImage	Извлекает индекс образа кнопки.
CMFCToolBarButton::GetInvalidateRect	Извлекает область клиентской области кнопки, в которой должен перерисовать.
CMFCToolBarButton::GetParentWnd	Возвращает родительское окно кнопки.
CMFCToolBarButton::GetProtectedCommands	Извлекает список команд, которые пользователь не может настраивать.
CMFCToolBarButton::GetTextSize	Получает размер текста кнопки.
CMFCToolBarButton::HasFocus	Указывает, имеет ли кнопка текущий фокус ввода.
CMFCToolBarButton::HaveHotBorder	Указывает, отображается ли граница кнопки, когда пользователь выбирает кнопку.
CMFCToolBarButton::IsDrawImage	Указывает, отображается ли образ на кнопке.
CMFCToolBarButton::IsDrawText	Указывает, отображается ли метка текстовой подписи на кнопке.
CMFCToolBarButton::IsDroppedDown	Определяет, указывает ли кнопка подменю.
CMFCToolBarButton::IsEditable	Определяет, является ли кнопка можно настраивать.
CMFCToolBarButton::IsExtraSize	Определяет, является ли кнопка может отображаться с расширенной границей.
CMFCToolBarButton::IsFirstInGroup	Определяет, является ли кнопка в первую позицию в этой группе кнопки.
CMFCToolBarButton::IsHidden	Определяет скрыта ли кнопка.
CMFCToolBarButton::IsHorizontal	Определяет, является ли найдено кнопки на горизонтальной панели инструментов.
CMFCToolBarButton::IsLastInGroup	Определяет, является ли кнопка в последней позиции в этой группе кнопки.
CMFCToolBarButton::IsLocked	Определяет, является ли кнопка панели инструментов, блокированных (настраиваемой).
CMFCToolBarButton::IsOwnerOf	Определяет, является ли кнопка владелец предоставленного дескриптора окна.
CMFCToolBarButton::IsVisible	Указывает, видима ли кнопка панели инструментов.
CMFCToolBarButton::IsWindowVisible	Определяет, является ли базовый дескриптор окна кнопки становится видимым.
CMFCToolBarButton::NotifyCommand	Определяет, выполняет ли кнопка сообщение WM_COMMAND.
CMFCToolBarButton::OnAddToCustomizePage	Вызываемый платформой, когда кнопка будет добавлена к компоненту Настроить.
CMFCToolBarButton::OnBeforeDrag	Определяет, является ли кнопка можно перетаскивать.
CMFCToolBarButton::OnBeforeDrop	Указывает, может ли пользователь кнопку удалить на панели инструментов целевого объекта.
CMFCToolBarButton::OnCalculateSize	Вызываемый платформой, чтобы вычислить размер кнопки для указанного контекста устройства и состояния закрепления.
CMFCToolBarButton::OnCancelMode	Вызываемый платформой для обработки сообщения WM_CANCELMODE.
CMFCToolBarButton::OnChangeParentWnd	Вызываемый платформой, если кнопка будет вставлена в новую панель инструментов.
CMFCToolBarButton::OnClick	Вызываемый платформой, когда пользователь нажимает кнопку мыши.
CMFCToolBarButton::OnClickUp	Вызываемый платформой, когда пользователь освобождает кнопки мыши.
CMFCToolBarButton::OnContextHelp	Вызываемый платформой если панель инструментов WM_HELPHITTEST родителя обрабатывающий сообщение.
CMFCToolBarButton::OnCtlColor	Вызываемый платформой если панель инструментов WM_CTLCOLOR родителя обрабатывающий сообщение.
CMFCToolBarButton::OnCustomizeMenu	Разрешает кнопку, чтобы изменить предоставленный меню, когда приложение отображает контекстное меню в родительской панели инструментов.
CMFCToolBarButton::OnDblClk	Вызываемый платформой если панель инструментов WM_LBUTTONDBLCLK родителя обрабатывающий сообщение.
CMFCToolBarButton::OnDraw	Вызываемый платформой для рисования кнопки с помощью указанных стилей и параметров.
CMFCToolBarButton::OnDrawOnCustomizeList	Вызываемый платформой для рисования кнопки на панели Команды диалогового окна Настроить.
CMFCToolBarButton::OnGetCustomToolTipText	Вызываемый платформой для получения пользовательский текст всплывающей подсказки для кнопки.
CMFCToolBarButton::OnGlobalFontsChanged	Вызываемый платформой, если глобальный шрифт изменяется.
CMFCToolBarButton::OnMove	Вызываемый платформой, если родительская панель инструментов.
CMFCToolBarButton::OnShow	Когда кнопка становится видимой называется структурой или невидимой.
CMFCToolBarButton::OnSize	Вызываемый платформой, если родительская панели инструментов меняет его размер или положение и это изменение требуют кнопку изменяет размер.
CMFCToolBarButton::OnToolHitTest	Вызываемый платформой, если родительская панель инструментов должна определить, находится ли точка в ограничивающем прямоугольнике кнопки.
CMFCToolBarButton::OnUpdateToolTip	Вызываемый платформой, если родительская панель инструментов обновляет его текст подсказки.
CMFCToolBarButton::PrepareDrag	Вызывается инфраструктурой при нажатии кнопки " собирается выполнять операции перетаскивания.
CMFCToolBarButton::Rect	Получает ограничивающий прямоугольник кнопки.
CMFCToolBarButton::ResetImageToDefault	Наборы по умолчанию образ, который связан с кнопкой.
CMFCToolBarButton::SaveBarState	Сохраняет состояние кнопки панели инструментов.
CMFCToolBarButton::Serialize	Считывает этот объект из архива или записывает его в архив. (Переопределяет CObject::Serialize).
CMFCToolBarButton::SetACCData	Заполняет предоставленный объект CAccessibilityData со сведениями о специальных возможностей от кнопки панели инструментов.
CMFCToolBarButton::SetClipboardFormatName	Переименовывает глобальный формат буфера обмена.
CMFCToolBarButton::SetImage	Устанавливает индекс образа кнопки.
CMFCToolBarButton::SetProtectedCommands	Задает список команд, которые пользователь не может настраивать.
CMFCToolBarButton::SetRadio	Вызываемый платформой, если кнопка изменяет ее состояние флажка.
CMFCToolBarButton::SetRect	Задает прямоугольник кнопки.
CMFCToolBarButton::SetStyle	Задает стиль кнопки.
CMFCToolBarButton::SetVisible	Определяет, является ли кнопка видима.
CMFCToolBarButton::Show	Показать или скрывает кнопки.

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

Имя	Описание
CMFCToolBarButton::m_bImage	Указывает, отображается ли образ на кнопке.
CMFCToolBarButton::m_bText	Указывает, отображается ли метка текстовой подписи на кнопке.
CMFCToolBarButton::m_bTextBelow	Указывает, отображается ли метка текстовой подписи под образом на кнопке.
CMFCToolBarButton::m_bUserButton	Указывает, имеет ли определяемый пользователем кнопки образ.
CMFCToolBarButton::m_bWholeText	Определяет, указывает ли кнопка свою полнотекстовую метку, даже если она не адаптирует в ограничивающем прямоугольнике.
CMFCToolBarButton::m_bWrap	Указывает, будет ли кнопка рядом с разделителем переходит на следующую строку.
CMFCToolBarButton::m_bWrapText	Определяет, включаются ли многополосные текстовые подписи.
CMFCToolBarButton::m_nID	Идентификатор команды кнопки.
CMFCToolBarButton::m_nStyle	Стиль кнопки.
CMFCToolBarButton::m_strText	Текстовая подпись кнопки.

Заметки

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

Обычно кнопки панели инструментов можно настраивать. пользователь может перетащить кнопки из одной панели инструментов в другую и копировать, вставлять, удалять и изменять текстовые подписи и изображений. Для предотвращения пользователя от настройки панели инструментов можно блокировать панели инструментов в одном из 2 способов. Любой набор пометить bLocked к TRUE при вызове CMFCToolBar::LoadToolBar или добавляет идентификатор команды отдельной кнопки глобальный список защищенных команд с помощью метода CMFCToolBarButton::SetProtectedCommands.

CMFCToolBarButton возражает образы отображения из глобальных коллекций образов панели инструментов в приложении. Эти коллекции поддерживаются родительский элемент панели инструментов, Класс CMFCToolBar. Дополнительные сведения см. в разделе Класс CMFCToolBarImages.

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

Класс CMFCToolBarButton базового класса для других классов кнопки панели инструментов, как Класс CMFCToolBarMenuButton, Класс CMFCToolBarEditBoxButton и Класс CMFCToolBarComboBoxButton.

Пример

В следующем примере показано, как настроить объект CMFCToolBarButton с помощью различных методов в классе CMFCToolBarButton. Примере показано, как включить ввода мыши и клавиатуры, задать индекс образа кнопки установить ограничивающий прямоугольник кнопки и сделать кнопку видимым. Этот фрагмент кода является частью Образец набора вкладок.

   CMFCToolBarButton* pOffice2007 = NULL;
    int nIndex = -1;
    
    for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
    {
        // CMFCToolBar  m_wndToolBarTheme
        nIndex = m_wndToolBarTheme.CommandToIndex (uiCmd);

        CMFCToolBarButton* pButton = m_wndToolBarTheme.GetButton (nIndex);
    
        if (pButton != NULL)
        {
            pOffice2007 = pButton;
            break;
        }
    }


...


    pOffice2007->EnableWindow();
    pOffice2007->SetImage(1);
    pOffice2007->SetRect( CRect(1,1,1,1));
    pOffice2007->SetVisible();
    pOffice2007->Show(true);