Класс CToolBarCtrl

Статья
06/10/2015

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

class CToolBarCtrl : public CWnd

Члены

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

Имя	Описание
CToolBarCtrl::CToolBarCtrl	Создает объект CToolBarCtrl.

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

Имя	Описание
CToolBarCtrl::AddBitmap	Добавляет один или несколько изображений кнопок растрового изображения в список изображений кнопок, доступных для элемента управления панели инструментов.
CToolBarCtrl::AddButtons	Добавляет один или несколько кнопок к элементу управления " Панель инструментов.
CToolBarCtrl::AddString	Добавляет новую строку, передаваемого в качестве идентификатора ресурса в список панели инструментов внутреннее строк.
CToolBarCtrl::AddStrings	Добавляет новые строки или строк, переданных как указатель на буфер null-, разделенных строк в список панели инструментов внутреннее строк.
CToolBarCtrl::AutoSize	Изменяет размер элемента управления панели инструментов.
CToolBarCtrl::ChangeBitmap	Изменяет растровое изображение для кнопки в текущем элементе управления " Панель инструментов.
CToolBarCtrl::CheckButton	Проверка целостности или снимите клиринги данной кнопки в элементе управления " Панель инструментов.
CToolBarCtrl::CommandToIndex	Извлекает нулевой- основан индекс для кнопки, связанной с указанным идентификатором команды.
CToolBarCtrl::Create	Создает элемент управления " Панель инструментов и вложение его к объекту CToolBarCtrl.
CToolBarCtrl::CreateEx	Создает элемент управления " Панель инструментов с заданными стилей расширенными Windows и вложение его к объекту CToolBarCtrl.
CToolBarCtrl::Customize	Открывает диалоговое окно настройки панели инструментов.
CToolBarCtrl::DeleteButton	Удаляет из элемента управления кнопка панели инструментов.
CToolBarCtrl::EnableButton	Включение или отключение указанную кнопку в элементе управления " Панель инструментов.
CToolBarCtrl::GetAnchorHighlight	Извлекает параметр выделения привязки для панели инструментов.
CToolBarCtrl::GetBitmap	Извлекает индекс растрового изображения, связанного с кнопкой на панели инструментов.
CToolBarCtrl::GetBitmapFlags	Возвращает флаги, связанные с растровым изображением панели инструментов.
CToolBarCtrl::GetButton	Возвращает сведения об указанной кнопки в элементе управления " Панель инструментов.
CToolBarCtrl::GetButtonCount	Получает число кнопок в данный момент в элементе управления " Панель инструментов.
CToolBarCtrl::GetButtonInfo	Извлекает сведения для кнопок на панели инструментов.
CToolBarCtrl::GetButtonSize	Извлекает текущую ширину и высоту кнопок панели инструментов в пикселях.
CToolBarCtrl::GetColorScheme	Возвращает цветовую схему текущего элемента управления панели инструментов.
CToolBarCtrl::GetDisabledImageList	Извлекает список образа, элемент управления " Панель инструментов используется для отображения отключенных кнопок.
CToolBarCtrl::GetDropTarget	Извлекает интерфейс IDropTarget для элемента управления панели инструментов.
CToolBarCtrl::GetExtendedStyle	Получает расширенные стили для элемента управления панели инструментов.
CToolBarCtrl::GetHotImageList	Извлекает список образа, элемент управления " Панель инструментов "активном состоянии" используется для отображения кнопки. Горячая кнопка отображается выбранной, когда указатель мыши над ним.
CToolBarCtrl::GetHotItem	Извлекает индекс горячего элемента на панели инструментов.
CToolBarCtrl::GetImageList	Извлекает список образа, элемент управления " Панель инструментов используется для отображения кнопок в их состоянии по умолчанию.
CToolBarCtrl::GetInsertMark	Извлекает текущую знак вставки на панели инструментов.
CToolBarCtrl::GetInsertMarkColor	Возвращает цвет, используемый для рисования знак вставки на панели инструментов.
CToolBarCtrl::GetItemRect	Получает ограничивающий прямоугольник кнопки в элементе управления " Панель инструментов.
CToolBarCtrl::GetMaxSize	Извлекает полный размер всех видимых и разделители кнопок на панели инструментов.
CToolBarCtrl::GetMaxTextRows	Получает максимальное количество строк текста, отображаемых на кнопке панели инструментов.
CToolBarCtrl::GetMetrics	Извлекает метрики элемента управления панели инструментов.
CToolBarCtrl::GetPadding	Возвращает горизонтальную и вертикальная величина заполнения текущего элемента управления панели инструментов.
CToolBarCtrl::GetPressedImageList	Извлекает список образа, текущий элемент управления " Панель инструментов используется для представления кнопку в нажатом состоянии.
CToolBarCtrl::GetRect	Возвращает ограничивающий прямоугольник для указанной кнопки панели инструментов.
CToolBarCtrl::GetRows	Извлекает число строк, отображаемых в данный момент кнопок на панели инструментов.
CToolBarCtrl::GetState	Извлекает сведения о состоянии указанной кнопки в элементе управления " Панель инструментов, например, включен ли он, нажат или проверить.
CToolBarCtrl::GetString	Извлекает строку панели инструментов.
CToolBarCtrl::GetStyle	Получает стили в настоящий момент используется для элемента управления панели инструментов.
CToolBarCtrl::GetToolTips	Извлекает маркер управления всплывающей подсказки, если таковые имеются, связанного с элементом управления toolbar.
CToolBarCtrl::HideButton	Показать или скрывает указанную кнопку в элементе управления " Панель инструментов.
CToolBarCtrl::HitTest	Указывает, где точка находится в элементе управления " Панель инструментов.
CToolBarCtrl::Indeterminate	Задает или снимите клиринги непредвиденное (серое) состояние указанной кнопки в элементе управления " Панель инструментов.
CToolBarCtrl::InsertButton	Вставляет элемент управления кнопка на панели инструментов.
CToolBarCtrl::InsertMarkHitTest	Извлекает сведения о знака вставки для точки на панели инструментов.
CToolBarCtrl::IsButtonChecked	Указывает, является ли проверена указанную кнопку в элементе управления " Панель инструментов.
CToolBarCtrl::IsButtonEnabled	Указывает, является ли указанная кнопка включена в элементе управления " Панель инструментов.
CToolBarCtrl::IsButtonHidden	Указывает, является ли скрыта указанную кнопку в элементе управления " Панель инструментов.
CToolBarCtrl::IsButtonHighlighted	Проверяет состояние выделения кнопки панели инструментов.
CToolBarCtrl::IsButtonIndeterminate	Указывает, является ли состояние указанной кнопки в элементе управления "Панель инструментов" неожиданно (серый).
CToolBarCtrl::IsButtonPressed	Указывает, является ли указанная кнопка нажата в элементе управления " Панель инструментов.
CToolBarCtrl::LoadImages	Загружает образ растровых изображений в Панель инструментов элемента управления списка.
CToolBarCtrl::MapAccelerator	Сопоставляет символы сочетания клавиш к кнопке панели инструментов.
CToolBarCtrl::MarkButton	Устанавливает состояние выделения данной кнопки в элементе управления " Панель инструментов.
CToolBarCtrl::MoveButton	Перемещает кнопку из одного индекса в другой.
CToolBarCtrl::PressButton	Давления или выпуски указанную кнопку в элементе управления " Панель инструментов.
CToolBarCtrl::ReplaceBitmap	Заменяет существующий растровое изображение в текущем элементе управления " Панель инструментов с новым растровым изображением.
CToolBarCtrl::RestoreState	Извлекает состояние элемента управления панели инструментов.
CToolBarCtrl::SaveState	Сохраняет состояние элемента управления панели инструментов.
CToolBarCtrl::SetAnchorHighlight	Устанавливает параметр выделения привязки для панели инструментов.
CToolBarCtrl::SetBitmapSize	Задает размер bitmapped изображений, добавляемый к элементу управления " Панель инструментов.
CToolBarCtrl::SetButtonInfo	Задает сведения для существующей кнопок на панели инструментов.
CToolBarCtrl::SetButtonSize	Задает размер кнопок, добавляемый к элементу управления " Панель инструментов.
CToolBarCtrl::SetButtonStructSize	Задает размер структуры TBBUTTON.
CToolBarCtrl::SetButtonWidth	Задает минимальное и максимальное ширина кнопки в элементе управления " Панель инструментов.
CToolBarCtrl::SetCmdID	Задает идентификатор команды, которая должна быть отправлена к окну "Владелец", если указанная кнопка нажата.
CToolBarCtrl::SetColorScheme	Задает цветовую схему текущего элемента управления панели инструментов.
CToolBarCtrl::SetDisabledImageList	Задает список образа, элемент управления " Панель инструментов будет использоваться для отображения отключенных кнопок.
CToolBarCtrl::SetDrawTextFlags	Устанавливает флаги в функции Win32 DrawText, которая используется для рисования текста в заданном прямоугольнике, отформатированное в соответствии с например флаги установлены.
CToolBarCtrl::SetExtendedStyle	Задает расширенные стили для элемента управления панели инструментов.
CToolBarCtrl::SetHotImageList	Задает список образа, элемент управления " Панель инструментов "будет использоваться для отображения активном состоянии" кнопок.
CToolBarCtrl::SetHotItem	Задает активный элемент на панели инструментов.
CToolBarCtrl::SetImageList	Задает список образа, панель инструментов будет использоваться для отображения кнопок, в состоянии по умолчанию.
CToolBarCtrl::SetIndent	Устанавливает отступ для первой кнопки в элементе управления " Панель инструментов.
CToolBarCtrl::SetInsertMark	Задает текущую метку вставки панели инструментов.
CToolBarCtrl::SetInsertMarkColor	Устанавливает цвет, используемый для рисования знак вставки на панели инструментов.
CToolBarCtrl::SetMaxTextRows	Задает максимальное количество строк текста, отображаемых на кнопке панели инструментов.
CToolBarCtrl::SetMetrics	Устанавливает метрики элемента управления панели инструментов.
CToolBarCtrl::SetOwner	Устанавливает флажок, чтобы получать сообщения уведомления из элемента управления " Панель инструментов.
CToolBarCtrl::SetPadding	Задает горизонтальную и вертикальную заполнения текущего элемента управления панели инструментов.
CToolBarCtrl::SetPressedImageList	Задает список образа, текущий элемент управления " Панель инструментов используется для представления кнопку в нажатом состоянии.
CToolBarCtrl::SetRows	Задает число строк кнопок, отображаемых на панели инструментов.
CToolBarCtrl::SetState	Задает состояние для указанной кнопки в элементе управления " Панель инструментов.
CToolBarCtrl::SetStyle	Задает стили для элемента управления панели инструментов.
CToolBarCtrl::SetToolTips	Связывает элемент управления всплывающей подсказки с элементом управления toolbar.
CToolBarCtrl::SetWindowTheme	Задает визуальный стиль элемента управления панели инструментов.

Заметки

Этот элемент управления (и, следовательно, класс CToolBarCtrl ) доступны только для программ, выполняемых в рамках /98 Windows версии 3.51 и Windows NT 95 и более поздних версий.

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

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

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

Создайте объект CToolBarCtrl.
Вызовите Создание для создания элемента управления панели инструментов Windows общее и вложить его к объекту CToolBarCtrl. Укажите стиль панели инструментов с помощью стилей, как TBSTYLE_TRANSPARENT для прозрачной панели инструментов или TBSTYLE_DROPDOWN для кнопки панели инструментов обозреватель раскрывающиеся этого стиля.
Укажите способ кнопки, отображаемой на панели инструментов.
- Для использования образов растрового изображения для кнопок, добавление растровых изображений кнопок на панели инструментов, вызвав AddBitmap.
- Для использования изображений, отображаемых в списке завершения образа для кнопок, укажите список образа путем вызова SetImageList, SetHotImageList или SetDisabledImageList.
- Для использования меток строк для кнопок добавить строки на панели инструментов путем вызова AddString и/или AddStrings.
Добавление структуры кнопки панели инструментов путем вызова AddButtons.
Если требуется всплывающие подсказки для кнопки панели инструментов в окне "Владелец", не является CFrameWnd необходимо обрабатывать сообщения TTN_NEEDTEXT в поле "Владелец" панели инструментов, как описано в Обработка уведомления всплывающей подсказки. Если родительское окно панели инструментов выводится из CFrameWnd, всплывающие подсказки отображаются без какого-либо дополнительного автоматически, поскольку принудительное из CFrameWnd предоставляет используемый по умолчанию обработчик.
Если пользователь должен иметь возможность настраивать панели инструментов, то обработка сообщения уведомления настройки в поле "Владелец", как описано в Обработка уведомления настройки.

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

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

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

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

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

Дополнительные сведения об использовании CToolBarCtrl см. в разделе элементы управления и Использование CToolBarCtrl.