CToolBarCtrl

Класс CToolBarCtrl предоставляет функциональные возможности общих элементов управления панели инструментов Windows. Этот элемент управления (и, следовательно, класс CToolBarCtrl ) доступны только для программ, работающих под Windows 95 и Windows NT версии 3.51 и выше.

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

CToolBarCtrl объекты содержат несколько важных внутренних структур данных:, список растровых изображения кнопки или список изображений, список кнопку Метка жала и список TBBUTTON структур, которые связать изображения и/или строку с позицией, стиль, государства и команда Идентификатор кнопки. Каждый из элементов этих структур данных называется с нуля индексом. Перед тем, как можно использовать объект CToolBarCtrl , вы должны настроить эти структуры данных. Список строк может использоваться только для метки кнопок; не удается извлечь строки из панели инструментов.

Чтобы использовать объект CToolBarCtrl , вы как правило выполняются следующие действия:

  1. CToolBarCtrl объект.

  2. Вызовите Create для создания общих элементов управления панели инструментов Windows и прикрепить его к CToolBarCtrl объекту. Укажите стиль панели инструментов с помощью стилей, такие как TBSTYLE_TRANSPARENT для прозрачной панели инструментов или TBSTYLE_DROPDOWN для панели инструментов, который поддерживает списком стиль кнопок.

  3. Определить расположение кнопок на панели инструментов отображается:
    • Для использования растровых изображений для кнопок, добавьте рисунки кнопки на панель инструментов путем вызова AddBitmap.

    • Чтобы использовать изображения отображаются из списка изображений для кнопок, укажите список изображений путем вызова SetImageList, SetHotImageListили SetDisabledImageList.

    • Чтобы использовать строки меток для кнопок, добавьте строки на панель инструментов, вызвав AddString и/или AddStrings.
  4. Добавить на панель инструментов кнопку структуры путем вызова AddButtons.

  5. Если вы хотите всплывающие подсказки для кнопки панели инструментов в окно-владелец, не CFrameWnd, необходимо обработать сообщения TTN_NEEDTEXT в панели инструментов окно-владелец, как описано в CToolBarCtrl: обработка инструмент подсказка уведомления. Если родительское окно панели инструментов является производным от CFrameWnd, всплывающие подсказки отображаются без каких-либо дополнительных усилий от вас, потому что CFrameWnd предоставляет обработчик по умолчанию.

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

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

Поддержка Internet Explorer версии 4.0 и выше

Для поддержки функциональности в Internet Explorer версии 4.0 и более поздних, MFC предоставляет поддержку списка изображений и прозрачным и плоские стили для элементов управления toolbar.

Прозрачной панели инструментов позволяет клиенту под панелью инструментов показывать путь. Для создания прозрачной панели инструментов, используйте стили TBSTYLE_FLAT и TBSTYLE_TRANSPARENT . Прозрачный панели инструментов функция горячей отслеживания; то есть когда указатель мыши перемещается над горячие кнопки на панели инструментов, вид кнопки меняется. Панели инструментов, созданные с только что TBSTYLE_FLAT стиль будет содержать кнопки, которые не являются транспарентными.

Поддержка списка изображений обеспечивает большую гибкость управления поведением по умолчанию, горячие изображения и инвалидов изображения. Использовать GetImageList, GetHotImageListи GetDisabledImageList с прозрачной панели инструментов для обработки изображения в соответствии с его состояние:

Для получения дополнительных сведений об использовании CToolBarCtrl, см. Управления темы и С помощью CToolBarCtrl в руководство Visual C++ программиста.

# include lt;afxcmn.h>

Члены классаБазовый класс | Иерархическая схема

Образцыnbsp; MFC образца CMNCTRL1 | Образца MFC в образце MFCIE

См. также CToolBar

Index