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

Класс CToolBarCtrl

  • Статья

Предоставляет функциональные возможности стандартного элемента управления "панель инструментов" 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 Извлекает дескриптор элемента управления подсказки средства, если он есть, связанный с элементом управления панели инструментов.
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 Задает размер битовых изображений, добавляемых в элемент управления панелью инструментов.
CToolBarCtrl::SetButtonInfo Задает сведения для существующей кнопки на панели инструментов.
CToolBarCtrl::SetButtonSize Задает размер кнопок, добавляемых в элемент управления панелью инструментов.
CToolBarCtrl::SetButtonStructSize Указывает размер TBBUTTON структуры.
CToolBarCtrl::SetButtonWidth Задает минимальную и максимальную ширину кнопки в элементе управления панели инструментов.
CToolBarCtrl::SetCmdID Задает идентификатор команды, отправляемый в окно владельца при нажатии указанной кнопки.
CToolBarCtrl::SetColorScheme Задает цветовую схему текущего элемента управления панели инструментов.
CToolBarCtrl::SetDisabledImageList Задает список изображений, используемый элементом управления панели инструментов для отображения отключенных кнопок.
CToolBarCtrl::SetDrawTextFlags Задает флаги в функции DrawTextWin32, которая используется для рисования текста в указанном прямоугольнике, отформатированного в соответствии с тем, как заданы флаги.
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 Связывает элемент управления подсказки средства с элементом управления панели инструментов.
CToolBarCtrl::SetWindowTheme Задает визуальный стиль элемента управления панели инструментов.

Замечания

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

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

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

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

  1. CToolBarCtrl Создайте объект.

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

  3. Определите, как отображаются кнопки на панели инструментов:

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

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

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

  4. Добавление структур кнопок на панель инструментов путем вызова AddButtons.

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

  6. Если вы хотите, чтобы пользователь мог настроить панель инструментов, обработайте уведомления о настройке в окне владельца, как описано в разделе "Обработка уведомлений о настройке".

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

Поддержка Internet Explorer версии 4.0 и более поздних версий

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

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

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

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

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

CObject

CCmdTarget

CWnd

CToolBarCtrl

Требования

Заголовок: afxcmn.h

CToolBarCtrl::AddBitmap

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

int AddBitmap(
    int nNumButtons,
    UINT nBitmapID);

int AddBitmap(
    int nNumButtons,
    CBitmap* pBitmap);

Параметры

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

nBitmapID
Идентификатор ресурса растрового изображения, содержащего изображение кнопки или изображения для добавления.

pBitmap
Указатель на CBitmap объект, содержащий изображение кнопки или изображения для добавления.

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

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

Замечания

Api CreateMappedBitmap Windows можно использовать для сопоставления цветов перед добавлением растрового изображения на панель инструментов. При передаче указателя на CBitMap объект необходимо убедиться, что растровое изображение не будет уничтожено до тех пор, пока панель инструментов не будет уничтожена.

CToolBarCtrl::AddButtons

Добавляет одну или несколько кнопок в элемент управления панелью инструментов.

BOOL AddButtons(
    int nNumButtons,
    LPTBBUTTON lpButtons);

Параметры

nNumButtons
Количество кнопок для добавления.

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

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

Указатель lpButtons указывает на массив TBBUTTON структур. Каждая TBBUTTON структура связывает кнопку, добавляемую с стилем, изображением и /или строкой, идентификатором команды, состоянием и пользовательскими данными:

typedef struct _TBBUTTON {
    int iBitmap;    // zero-based index of button image
    int idCommand;  // command to be sent when button pressed
    BYTE fsState;   // button state--see below
    BYTE fsStyle;   // button style--see below
    DWORD dwData;   // application-defined value
    int iString;    // zero-based index of button label string
} TBBUTTON;

Члены приведены следующим образом:

  • iBitmap

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

  • idCommand

    Идентификатор команды, связанный с кнопкой. Этот идентификатор отправляется в сообщении WM_COMMAND при выборе кнопки. fsStyle Если элемент имеет TBSTYLE_SEP значение, этот элемент должен быть равен нулю.

  • fsState

    Флаги состояния кнопки. Это может быть сочетание значений, перечисленных ниже:

    • TBSTATE_CHECKED Кнопка имеет TBSTYLE_CHECKED стиль и нажимается.

    • TBSTATE_ENABLED Кнопка принимает входные данные пользователя. Кнопка, которая не имеет этого состояния, не принимает входные данные пользователя и серый.

    • TBSTATE_HIDDEN Кнопка не отображается и не может получать входные данные пользователя.

    • TBSTATE_INDETERMINATE Кнопка серая.

    • TBSTATE_PRESSED Кнопка нажимается.

    • TBSTATE_WRAP Разрыв строки следует за кнопкой. Кнопка также должна иметь TBSTATE_ENABLED состояние.

  • fsStyle

    Стиль кнопки. Это может быть сочетание значений, перечисленных ниже:

    • TBSTYLE_BUTTON Создает стандартную кнопку нажатия.

    • TBSTYLE_CHECK Создает кнопку, которая переключается между нажатием и несжатыми состояниями каждый раз, когда пользователь щелкает его. Кнопка имеет другой цвет фона, если он находится в состоянии нажатия.

    • TBSTYLE_CHECKGROUP Создает кнопку проверки, которая остается нажимаемой до нажатия другой кнопки в группе.

    • TBSTYLE_GROUP Создает кнопку, которая остается нажимаемой до нажатия другой кнопки в группе.

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

  • dwData

    Определяемые пользователем данные.

  • iString

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

Изображение и /или строка, индекс которой вы указали, должен быть добавлен в список элементов управления панели инструментов с помощью AddBitmap, AddStringи/или AddStrings.

CToolBarCtrl::AddString

Добавляет новую строку, передаваемую в качестве идентификатора ресурса, в внутренний список строк панели инструментов.

int AddString(UINT nStringID);

Параметры

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

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

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

CToolBarCtrl::AddStrings

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

int AddStrings(LPCTSTR lpszStrings);

Параметры

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

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

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

Замечания

Строки в буфере должны быть разделены символом NULL . Необходимо убедиться, что последняя строка имеет два NULL конца. Чтобы правильно отформатировать константную строку, ее можно написать следующим образом:

// one null added automatically
lpszStrings = _T("Only one string to add\0");

или:

// adds three strings with one call
lpszStrings = _T("String 1\0String 2\0String 3\0");

Не следует передавать CString объект в эту функцию, так как в ней не может быть несколько NULL символов CString.

CToolBarCtrl::AutoSize

Изменяет размер всего элемента управления панели инструментов.

void AutoSize();

Замечания

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

CToolBarCtrl::ChangeBitmap

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

BOOL ChangeBitmap(
    int idButton,
    int iBitmap);

Параметры

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

iBitmap
[in] Отсчитываемый от нуля индекс изображения в списке изображений текущего элемента управления панели инструментов.

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

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

Замечания

Если этот метод выполнен успешно, система отображает указанное изображение в указанной кнопке.

Этот метод отправляет TB_CHANGEBITMAP сообщение, описанное в пакете SDK для Windows.

Пример

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

{
   // Change the bitmap for the File Save button, whose
   // command ID is ID_FILE_SAVE, to the bitmap for the
   // About button, whose index is 7.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ChangeBitmap(ID_FILE_SAVE, 7);
}

CToolBarCtrl::CheckButton

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

BOOL CheckButton(
    int nID,
    BOOL bCheck = TRUE);

Параметры

nID
Идентификатор команды кнопки для проверки или очистки.

bCheck
TRUE чтобы проверить кнопку, FALSE чтобы очистить ее.

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

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

CToolBarCtrl::CommandToIndex

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

UINT CommandToIndex(UINT nID) const;

Параметры

nID
Идентификатор команды, индекс кнопки которого требуется найти.

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

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

Замечания

CToolBarCtrl::Create

Создает элемент управления панели инструментов и присоединяет его к объекту CToolBarCtrl .

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Параметры

dwStyle
Задает стиль элемента управления панели инструментов. Панели инструментов всегда должны иметь WS_CHILD стиль. Кроме того, можно указать любое сочетание стилей панели инструментов и стилей окон, как описано в разделе "Примечания".

rect
При необходимости указывает размер и позицию элемента управления панели инструментов. Это может быть CRect объект или RECT структура.

pParentWnd
Указывает родительское окно элемента управления панели инструментов. Это не должно быть NULL.

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

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

Вы создаете два CToolBarCtrl шага. Сначала вызовите конструктор и вызов Create, который создает элемент управления панели инструментов и присоединяет его к объекту CToolBarCtrl . Примените следующие стили окон к элементу управления панели инструментов.

  • WS_CHILD Всегда

  • WS_VISIBLE Обычно

  • WS_DISABLED Редко

Сведения о стилях окон см CreateWindow . в пакете SDK для Windows.

При необходимости примените сочетание общих стилей элементов управления, как описано в пакете SDK для Windows.

Примените сочетание стилей панели инструментов к элементу управления или кнопок. Стили описаны в разделе "Элемент управления панелью инструментов" и "Стили кнопок" в пакете SDK для Windows.

Чтобы использовать расширенные стили панели инструментов, вызовите SetExtendedStyle после вызова Create. Чтобы создать панель инструментов с расширенными стилями окон, вызовите CToolBarCtrl::CreateEx вместо Createнего.

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

CToolBarCtrl::CreateEx

Создает элемент управления (дочернее окно) и связывает его с CToolBarCtrl объектом.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Параметры

dwExStyle
Задает расширенный стиль создаваемого элемента управления. Список расширенных стилей Windows см dwExStyle . в параметре CreateWindowEx пакета SDK для Windows.

dwStyle
Задает стиль элемента управления панели инструментов. Панели инструментов всегда должны иметь WS_CHILD стиль. Кроме того, можно указать любое сочетание стилей панели инструментов и стилей окон, как описано в разделе Create"Примечания".

rect
Ссылка на RECT структуру, описывающую размер и положение создаваемого окна в координатах pParentWndклиента.

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

nID
Идентификатор дочернего окна элемента управления.

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

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

Замечания

Используйте CreateEx вместо Create применения расширенных стилей Windows, указанных предисловием WS_EX_расширенного стиля Windows. CreateEx создает элемент управления с расширенными стилями Windows, указанными dwExStyle. Задайте расширенные стили, относящиеся к элементу управления, с помощью SetExtendedStyle. Например, используйте CreateEx для задания таких стилей, как WS_EX_CONTEXTHELP, но используйте SetExtendedStyle для задания таких стилей, как TBSTYLE_EX_DRAWDDARROWS. Дополнительные сведения см. в статье о стилях, описанных в расширенных стилях панели инструментов в пакете SDK для Windows.

CToolBarCtrl::CToolBarCtrl

Формирует объект CToolBarCtrl.

CToolBarCtrl();

Замечания

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

CToolBarCtrl::Customize

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

void Customize();

Замечания

Это диалоговое окно позволяет пользователю настраивать панель инструментов, добавляя и удаляя кнопки. Чтобы поддерживать настройку, родительское окно панели инструментов должно обрабатывать сообщения уведомлений о настройке, как описано в разделе "Обработка уведомлений о настройке". Панель инструментов также должна быть создана с CCS_ADJUSTABLE помощью стиля, как описано в CToolBarCtrl::Createразделе .

CToolBarCtrl::DeleteButton

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

BOOL DeleteButton(int nIndex);

Параметры

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

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

CToolBarCtrl::EnableButton

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

BOOL EnableButton(
    int nID,
    BOOL bEnable = TRUE);

Параметры

nID
Идентификатор команды кнопки для включения или отключения.

bEnable
Значение TRUE для включения кнопки. Значение FALSE для выключения кнопки.

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

Если кнопка включена, ее можно нажать и проверить. Если вы хотите изменить несколько состояний кнопки, рассмотрите возможность вызова SetState .

CToolBarCtrl::GetAnchorHighlight

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

BOOL GetAnchorHighlight() const;

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

Если ненулевое значение, выделение привязки включено. Если ноль, выделение привязки отключено.

Замечания

Эта функция-член реализует поведение сообщения TB_GETANCHORHIGHLIGHTWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::GetBitmap

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

int GetBitmap(int nID) const;

Параметры

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

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

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

Замечания

Реализует функциональные TB_GETBITMAP возможности пакета SDK для Windows.

CToolBarCtrl::GetBitmapFlags

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

UINT GetBitmapFlags() const;

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

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

Замечания

Его следует вызвать после создания панели инструментов, но перед добавлением растровых изображений на панель инструментов. Возвращаемое значение указывает, поддерживает ли дисплей большие растровые изображения. Если дисплей поддерживает большие растровые изображения и если вы решили их использовать, вызовите SetBitmapSize и SetButtonSize перед добавлением большого растрового изображения.AddBitmap

CToolBarCtrl::GetButton

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

BOOL GetButton(
    int nIndex,
    LPTBBUTTON lpButton) const;

Параметры

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

lpButton
TBBUTTON Адрес структуры, которая требуется получить копию сведений о кнопке. Дополнительные сведения о структуре см. в TBBUTTON статьеCToolBarCtrl::AddButtons.

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

Ненулевое значение в случае успеха, иначе — 0.

CToolBarCtrl::GetButtonCount

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

int GetButtonCount() const;

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

Количество кнопок.

CToolBarCtrl::GetButtonInfo

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

int GetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi) const;

Параметры

nID
Идентификатор кнопки.

ptbbi
Указатель на TBBUTTONINFO структуру, которая получает сведения о кнопке.

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

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

Замечания

Эта функция-член реализует поведение сообщения TB_GETBUTTONINFOWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::GetButtonSize

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

DWORD GetButtonSize() const;

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

Значение DWORD , содержащее значения ширины и высоты в LOWORD и HIWORDсоответственно.

CToolBarCtrl::GetButtonText

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

CString GetButtonText(int idButton) const;

Параметры

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

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

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

Замечания

Этот метод отправляет TB_GETBUTTONTEXT сообщение, описанное в пакете SDK для Windows.

CToolBarCtrl::GetColorScheme

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

BOOL GetColorScheme(COLORSCHEME* lpColorScheme) const;

Параметры

lpColorScheme
[out] Указатель на структуру, которая получает сведения о цветовой COLORSCHEME схеме. При возврате этого метода структура описывает цвет выделения и цвет тени элемента управления панели инструментов.

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

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

Замечания

Этот метод отправляет TB_GETCOLORSCHEME сообщение, описанное в пакете SDK для Windows.

CToolBarCtrl::GetDisabledImageList

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

CImageList* GetDisabledImageList() const;

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

Указатель на CImageList объект или NULL если список отключенных изображений не задан.

Замечания

Эта функция-член реализует поведение сообщения TB_GETDISABLEDIMAGELISTWin32, как описано в пакете SDK для Windows. Реализация MFC GetDisabledImageList использует CImageList объект, содержащий изображения кнопки панели инструментов, а не дескриптор списка изображений.

CToolBarCtrl::GetDropTarget

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

HRESULT GetDropTarget(IDropTarget** ppDropTarget) const;

Параметры

ppDropTarget
Указатель на IDropTarget указатель интерфейса. При возникновении NULL ошибки указатель помещается в этот адрес.

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

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

Замечания

Эта функция-член реализует поведение сообщения TB_GETOBJECTWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::GetExtendedStyle

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

DWORD GetExtendedStyle() const;

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

Объект, DWORD представляющий расширенные стили, используемые в настоящее время для элемента управления панелью инструментов. Список стилей см. в статье "Расширенные стили панели инструментов" в пакете SDK для Windows.

Замечания

Эта функция-член реализует поведение сообщения TB_GETEXTENDEDSTYLEWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::GetHotImageList

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

CImageList* GetHotImageList() const;

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

Указатель на CImageList объект или NULL если список отключенных изображений не задан.

Замечания

Эта функция-член реализует поведение сообщения TB_GETHOTIMAGELISTWin32, как описано в пакете SDK для Windows. Горячая кнопка отображается, когда указатель мыши находится над ним.

CToolBarCtrl::GetHotItem

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

int GetHotItem() const;

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

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

Замечания

Эта функция-член реализует поведение сообщения TB_GETHOTITEMWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::GetImageList

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

CImageList* GetImageList() const;

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

Указатель на CImageList объект или NULL если список изображений не задан.

Замечания

Эта функция-член реализует поведение сообщения TB_GETIMAGELISTWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::GetInsertMark

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

void GetInsertMark(TBINSERTMARK* ptbim) const;

Параметры

ptbim
Указатель на TBINSERTMARK структуру, которая получает знак вставки.

Замечания

Эта функция-член реализует поведение сообщения TB_GETINSERTMARKWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::GetInsertMarkColor

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

COLORREF GetInsertMarkColor() const;

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

Значение COLORREF , содержащее текущий цвет метки вставки.

Замечания

Эта функция-член реализует поведение сообщения TB_GETINSERTMARKCOLORWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::GetItemRect

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

BOOL GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Параметры

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

lpRect
RECT Адрес структуры или CRect объекта, получающего координаты ограничивающего прямоугольника.

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

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

CToolBarCtrl::GetMaxSize

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

BOOL GetMaxSize(LPSIZE pSize) const;

Параметры

pSize
Указатель на SIZE структуру, которая получает размер элементов.

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

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

Замечания

Эта функция-член реализует поведение сообщения TB_GETMAXSIZEWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::GetMaxTextRows

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

int GetMaxTextRows() const;

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

Максимальное количество текстовых строк, отображаемых на кнопке панели инструментов.

CToolBarCtrl::GetMetrics

Извлекает метрики CToolBarCtrl объекта.

void GetMetrics(LPTBMETRICS ptbm) const;

Параметры

ptbm
Указатель на TBMETRICS структуру CToolBarCtrl объекта.

Замечания

Эта функция-член эмулирует функциональные возможности TB_GETMETRICS сообщения, как описано в пакете SDK для Windows.

CToolBarCtrl::GetPadding

Извлекает горизонтальное и вертикальное заполнение текущего элемента управления панели инструментов.

BOOL GetPadding(
    int* pnHorzPadding,
    int* pnVertPadding) const;

Параметры

pnHorzPadding
[out] Целое число, которое получает горизонтальное заполнение элемента управления панели инструментов в пикселях.

pnVertPadding
[out] Целое число, которое получает вертикальное заполнение элемента управления панелью инструментов в пикселях.

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

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

Замечания

Этот метод отправляет TB_GETPADDING сообщение, описанное в пакете SDK для Windows.

CToolBarCtrl::GetPressedImageList

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

CImageList* GetPressedImageList();

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

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

Замечания

Этот метод отправляет TB_GETPRESSEDIMAGELIST сообщение, описанное в пакете SDK для Windows.

CToolBarCtrl::GetRect

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

BOOL GetRect(
    int nID,
    LPRECT lpRect) const;

Параметры

nID
Идентификатор кнопки.

lpRect
Указатель на RECT структуру для получения ограничивающих прямоугольников.

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

Значение TRUE в случае успешного выполнения; в противном случае — значение FALSE.

Замечания

Эта функция-член реализует поведение сообщения TB_GETRECTWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::GetRows

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

int GetRows() const;

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

Количество строк кнопок, отображаемых на панели инструментов.

Замечания

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

CToolBarCtrl::GetState

Извлекает сведения о состоянии указанной кнопки в элементе управления панелью инструментов, например о включении, нажатии или проверке.

int GetState(int nID) const;

Параметры

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

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

Сведения о состоянии кнопки, если это успешно или -1 в противном случае. Сведения о состоянии кнопки могут быть сочетанием значений, перечисленных в CToolBarCtrl::AddButtons.

Замечания

Эта функция особенно удобна, если вы хотите получить несколько состояний кнопки. Чтобы получить одно состояние, используйте одну из следующих функций-членов: IsButtonEnabled, , IsButtonChecked, IsButtonHiddenIsButtonPressedили IsButtonIndeterminate. GetState Однако функция-член является единственным способом обнаружения состояния кнопкиTBSTATE_WRAP.

CToolBarCtrl::GetString

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

int GetString(
    int nString,
    LPTSTR lpstrString,
    int cchMaxLen) const;

int GetString(
    int nString,
    CString& str) const;

Параметры

nString
Индекс строки.

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

cchMaxLen
Длина буфера в байтах.

str
Строка.

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

Длина строки в случае успешного выполнения —1, если нет.

Замечания

Эта функция-член реализует поведение сообщения TB_GETSTRINGWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::GetStyle

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

DWORD GetStyle() const;

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

Сочетание DWORD стилей элементов управления панели инструментов, как описано в пакете SDK для Windows.

CToolBarCtrl::GetToolTips

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

CToolTipCtrl* GetToolTips() const;

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

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

Замечания

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

CToolBarCtrl::HitTest

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

int HitTest(LPPOINT ppt) const;

Параметры

ppt
Указатель на POINT структуру, содержащую координату x теста попадания в x члене и координату y теста попадания в элементе y . Координаты относятся к клиентской области панели инструментов.

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

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

Если возвращаемое значение отрицательно, точка не находится в кнопке. Абсолютное значение возвращаемого значения — это индекс элемента разделителя или ближайшего элемента, не относящееся к значению.

Замечания

Эта функция-член реализует поведение сообщения TB_HITTESTWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::HideButton

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

BOOL HideButton(
    int nID,
    BOOL bHide = TRUE);

Параметры

nID
Идентификатор команды кнопки для скрытия или отображения.

bHide
TRUE чтобы скрыть кнопку, FALSE чтобы отобразить ее.

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

Если вы хотите изменить несколько состояний кнопки, рассмотрите возможность вызова SetState .

CToolBarCtrl::Indeterminate

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

BOOL Indeterminate(
    int nID,
    BOOL bIndeterminate = TRUE);

Параметры

nID
Идентификатор команды кнопки, неопределенное состояние которой необходимо задать или очистить.

bIndeterminate
TRUE чтобы задать неопределенное состояние для указанной кнопки, FALSE чтобы очистить ее.

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

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

CToolBarCtrl::InsertButton

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

BOOL InsertButton(
    int nIndex,
    LPTBBUTTON lpButton);

Параметры

nIndex
Отсчитываемый от нуля индекс кнопки. Эта функция вставляет новую кнопку слева от этой кнопки.

lpButton
TBBUTTON Адрес структуры, содержащей сведения о кнопке для вставки. См CToolBarCtrl::AddButtons . описание TBBUTTON структуры.

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

Изображение и /или строка, индекс которой вы указали, должен быть добавлен в список элементов управления панели инструментов с помощью AddBitmap, AddStringи/или AddStrings.

CToolBarCtrl::InsertMarkHitTest

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

BOOL InsertMarkHitTest(
    LPPOINT ppt,
    LPTBINSERTMARK ptbim) const;

Параметры

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

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

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

Эта функция-член реализует поведение сообщения TB_INSERTMARKHITTESTWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::IsButtonChecked

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

BOOL IsButtonChecked(int nID) const;

Параметры

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

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

Ненулевое значение, если установлен флажок кнопки; в противном случае ноль.

Замечания

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

CToolBarCtrl::IsButtonEnabled

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

BOOL IsButtonEnabled(int nID) const;

Параметры

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

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

Ненулевое значение, если кнопка включена; в противном случае ноль.

Замечания

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

CToolBarCtrl::IsButtonHidden

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

BOOL IsButtonHidden(int nID) const;

Параметры

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

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

Ненулевое значение, если кнопка скрыта; в противном случае ноль.

Замечания

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

CToolBarCtrl::IsButtonHighlighted

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

BOOL IsButtonHighlighted(int nID) const;

Параметры

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

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

Положительное целое число, если кнопка выделена, 0, если кнопка не выделена, или -1, если возникает ошибка.

CToolBarCtrl::IsButtonIndeterminate

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

BOOL IsButtonIndeterminate(int nID) const;

Параметры

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

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

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

Замечания

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

CToolBarCtrl::IsButtonPressed

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

BOOL IsButtonPressed(int nID) const;

Параметры

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

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

Ненулевое значение, если кнопка нажимается, в противном случае — ноль.

Замечания

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

CToolBarCtrl::LoadImages

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

void LoadImages(
    int iBitmapID,
    HINSTANCE hinst);

Параметры

iBitmapID
Идентификатор растрового изображения, содержащего загруженные изображения. Чтобы указать собственный ресурс растрового изображения, задайте этот параметр идентификатору ресурса растрового изображения и задайте значение hInst NULL. Ресурс растрового изображения будет добавлен в список изображений в виде одного изображения. Вы можете добавить стандартные системные растровые карты, задав hinst HINST_COMMCTRL для этого параметра одно из следующих идентификаторов:

Идентификатор растрового рисунка Description
IDB_HIST_LARGE_COLOR Растровые изображения обозревателя большого размера
IDB_HIST_SMALL_COLOR Растровые изображения обозревателя в небольшом размере
IDB_STD_LARGE_COLOR Стандартные растровые изображения большого размера
IDB_STD_SMALL_COLOR Стандартные растровые изображения небольшого размера
IDB_VIEW_LARGE_COLOR Просмотр растровых изображений в большом размере
IDB_VIEW_SMALL_COLOR Просмотр растровых изображений в небольшом размере

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

Замечания

Эта функция-член реализует поведение сообщения TB_LOADIMAGESWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::MapAccelerator

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

BOOL MapAccelerator(
    TCHAR chAccel,
    UINT* pIDBtn);

Параметры

chAccel
Символ акселератора для сопоставлений. Этот символ совпадает с символом, подчеркивающимся в тексте кнопки.

pIDBtn
Указатель на UINT объект, который получает идентификатор команды кнопки, соответствующей акселератору, указанному в chAccel.

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

Эта функция-член реализует поведение сообщения TB_MAPACCELERATORWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::MarkButton

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

BOOL MarkButton(
    int nID,
    BOOL fHighlight = TRUE);

Параметры

nID
Идентификатор кнопки.

fHighlight
Указывает состояние выделения, которое нужно задать. По умолчанию TRUE. Если задано значение FALSE, кнопка устанавливается в его состояние по умолчанию.

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

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

Замечания

Эта функция-член реализует поведение сообщения TB_MARKBUTTONWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::MoveButton

Перемещает кнопку из одного индекса в другой.

BOOL MoveButton(
    UINT nOldPos,
    UINT nNewPos);

Параметры

nOldPos
Отсчитываемый от нуля индекс кнопки.

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

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

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

Замечания

Эта функция-член реализует поведение сообщения TB_MOVEBUTTONWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::PressButton

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

BOOL PressButton(int nID, BOOL bPress = TRUE);

Параметры

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

bPress
[in] TRUE для нажатия указанной кнопки; FALSE чтобы освободить указанную кнопку. Значение по умолчанию — TRUE.

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

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

Замечания

Если вы хотите изменить несколько состояний кнопки, рассмотрите возможность вызова SetState .

Этот метод отправляет TB_PRESSBUTTON сообщение, описанное в пакете SDK для Windows.

CToolBarCtrl::ReplaceBitmap

Заменяет существующее растровое изображение в текущем элементе управления панели инструментов новым растровым изображением.

BOOL ReplaceBitmap(LPTBREPLACEBITMAP pReplaceBitmap);

Параметры

pReplaceBitmap
[in] Указатель на структуру, описывающую точечный TBREPLACEBITMAP рисунок, который необходимо заменить, и новое растровое изображение.

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

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

Замечания

Этот метод отправляет TB_REPLACEBITMAP сообщение, описанное в пакете SDK для Windows.

Пример

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

{
   // Replace one toolbar bitmap with another.
   TBREPLACEBITMAP tbrb;
   tbrb.hInstOld = ::AfxGetInstanceHandle();
   tbrb.nIDOld = IDR_MAINFRAME;
   tbrb.hInstNew = ::AfxGetInstanceHandle();
   tbrb.nIDNew = IDR_MAINFRAME1;
   tbrb.nButtons = 8;
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ReplaceBitmap(&tbrb);
}

CToolBarCtrl::RestoreState

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

void RestoreState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Параметры

hKeyRoot
Определяет открытый раздел в реестре или любой из следующих предопределенных значений зарезервированных дескрипторов:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

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

lpszValueName
Указывает на строку, содержащую имя извлекаемого значения. Если значение с таким именем еще не присутствует в ключе, функция добавляет ее в ключ.

CToolBarCtrl::SaveState

Сохраняет состояние элемента управления панели инструментов в расположении в реестре, заданном параметрами.

void SaveState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Параметры

hKeyRoot
Определяет открытый раздел в реестре или любой из следующих предопределенных значений зарезервированных дескрипторов:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

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

lpszValueName
Указывает на строку, содержащую имя заданного значения. Если значение с таким именем еще не присутствует в ключе, функция добавляет ее в ключ.

CToolBarCtrl::SetAnchorHighlight

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

BOOL SetAnchorHighlight(BOOL fAnchor = TRUE);

Параметры

fAnchor
[in] Указывает, включена или отключена ли выделение привязки. Если это значение ненулевое, выделение привязки будет включено. Если это значение равно нулю, выделение привязки будет отключено

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

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

Замечания

Этот метод реализует поведение сообщения TB_SETANCHORHIGHLIGHTWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::SetBitmapSize

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

BOOL SetBitmapSize(CSize size);

Параметры

size
Ширина и высота (в пикселях) битовых изображений.

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

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

CToolBarCtrl::SetButtonInfo

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

BOOL SetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi);

Параметры

nID
Идентификатор кнопки.

ptbbi
Указатель на TBBUTTONINFO структуру, которая получает сведения о кнопке.

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

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

Замечания

Функция-член реализует поведение сообщения TB_SETBUTTONINFOWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::SetButtonSize

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

BOOL SetButtonSize(CSize size);

Параметры

size
Ширина и высота кнопок в пикселях.

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

Размер кнопки всегда должен быть не менее большим, чем размер битового изображения, который он заключит. Эта функция должна вызываться только перед добавлением растровых изображений на панель инструментов. Если приложение явно не задает размер кнопки, значение по умолчанию — 24 на 22 пикселя.

Пример

Пример см. в примере CToolBar::GetToolBarCtrl.

CToolBarCtrl::SetButtonStructSize

Указывает размер TBBUTTON структуры.

void SetButtonStructSize(int nSize);

Параметры

nSize
Размер структуры в байтах TBBUTTON .

Замечания

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

Дополнительные сведения о структуре см. в TBBUTTON статьеCToolBarCtrl::AddButtons.

CToolBarCtrl::SetButtonWidth

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

BOOL SetButtonWidth(
    int cxMin,
    int cxMax);

Параметры

cxMin
Минимальная ширина кнопки в пикселях. Кнопки панели инструментов никогда не будут более узкими, чем это значение.

cxMax
Максимальная ширина кнопки в пикселях. Если текст кнопки слишком широкий, элемент управления отображает его с многоточием.

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

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

Замечания

Эта функция-член реализует поведение сообщения TB_SETBUTTONWIDTHWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::SetCmdID

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

BOOL SetCmdID(
    int nIndex,
    UINT nID);

Параметры

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

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

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

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

CToolBarCtrl::SetColorScheme

Задает цветовую схему текущего элемента управления панели инструментов.

void SetColorScheme(const COLORSCHEME* lpColorScheme);

Параметры

lpColorScheme
[in] Указатель на COLORSCHEME структуру, описывающую цвет выделения и цвет тени элемента управления панели инструментов.

Замечания

Этот метод не действует, если задана визуальная тема Windows Vista.

Этот метод отправляет TB_SETCOLORSCHEME сообщение, описанное в пакете SDK для Windows.

Пример

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

//Set color scheme for the current toolbar control.
//Make the left and top edges of the tool button red,
//and the right and bottom edges blue. The colors
//reverse when a button is pressed.
//This method has no effect if the Vista visual theme
//is set.
{
   COLORSCHEME cs;
   cs.dwSize = sizeof(COLORSCHEME);
   cs.clrBtnHighlight = RGB(255, 0, 0);
   cs.clrBtnShadow = RGB(0, 0, 255);
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetColorScheme(&cs);
}

CToolBarCtrl::SetDisabledImageList

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

CImageList* SetDisabledImageList(CImageList* pImageList);

Параметры

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

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

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

Замечания

Эта функция-член реализует поведение сообщения TB_SETDISABLEDIMAGELISTWin32, как описано в пакете SDK для Windows. Реализация MFC использует CImageList объект, содержащий отключенные изображения кнопки SetDisabledImageList элемента управления панели инструментов, а не дескриптор списка изображений.

CToolBarCtrl::SetDrawTextFlags

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

DWORD SetDrawTextFlags(
    DWORD dwMask,
    DWORD dwDTFlags);

Параметры

dwMask
Сочетание одного или нескольких DT_ флагов, указанных в функции DrawTextWin32, указывающее, какие биты dwDTFlags будут использоваться при рисовании текста.

dwDTFlags
Сочетание одного или нескольких флагов, указанных DT_ в функции DrawTextWin32, указывающее, как будет вырисовываться текст кнопки. Это значение передается DrawText при рисовании текста кнопки.

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

Содержит DWORD предыдущие флаги рисования текста.

Замечания

Эта функция-член реализует поведение сообщения TB_SETDRAWTEXTFLAGSWin32, как описано в пакете SDK для Windows. Эта функция-член задает флаги в функции DrawTextWin32, которая рисует текст в указанном прямоугольнике, отформатированный в соответствии с тем, как заданы флаги.

CToolBarCtrl::SetExtendedStyle

Задает расширенные стили для элемента управления панелью инструментов.

DWORD SetExtendedStyle(DWORD dwExStyle);

Параметры

dwExStyle
Значение, указывающее новые расширенные стили. Этот параметр может быть сочетанием расширенных стилей панели инструментов.

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

Объект, DWORD представляющий предыдущие расширенные стили. Список стилей см. в статье "Расширенные стили панели инструментов" в пакете SDK для Windows.

Замечания

Эта функция-член реализует поведение сообщения TB_SETEXTENDEDSTYLEWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::SetHotImageList

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

CImageList* SetHotImageList(CImageList* pImageList);

Параметры

pImageList
Указатель на CImageList объект, содержащий изображения, которые будут использоваться элементом управления панели инструментов для отображения горячих кнопок.

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

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

Замечания

Эта функция-член реализует поведение сообщения TB_SETHOTIMAGELISTWin32, как описано в пакете SDK для Windows.

Реализация MFC SetHotImageList использует CImageList объект, содержащий горячие изображения кнопки элемента управления панели инструментов, а не дескриптор списка изображений. Горячая кнопка отображается, когда указатель над ним.

CToolBarCtrl::SetHotItem

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

int SetHotItem(int nHot);

Параметры

nHot
Отсчитываемый от нуля номер индекса элемента, который будет горячей. Если это значение равно -1, ни один из элементов не будет горячим.

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

Индекс предыдущего горячего элемента или -1, если не было горячего элемента.

Замечания

Эта функция-член реализует поведение сообщения TB_SETHOTITEMWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::SetImageList

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

CImageList* SetImageList(CImageList* pImageList);

Параметры

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

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

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

Замечания

Эта функция-член реализует поведение сообщения TB_SETIMAGELISTWin32, как описано в пакете SDK для Windows.

Реализация MFC SetImageList использует CImageList объект, содержащий изображения кнопки панели инструментов, а не дескриптор списка изображений.

CToolBarCtrl::SetIndent

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

BOOL SetIndent(int iIndent);

Параметры

iIndent
Значение, указывающее отступ в пикселях.

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

Ненулевое значение в случае успеха, иначе — 0.

CToolBarCtrl::SetInsertMark

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

void SetInsertMark(TBINSERTMARK* ptbim);

Параметры

ptbim
Указатель на TBINSERTMARK структуру, содержащую метку вставки.

Замечания

Эта функция-член реализует поведение сообщения TB_SETINSERTMARKWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::SetInsertMarkColor

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

COLORREF SetInsertMarkColor(COLORREF clrNew);

Параметры

clrNew
Значение COLORREF , содержащее новый цвет метки вставки.

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

Значение COLORREF , содержащее предыдущий цвет метки вставки.

Замечания

Эта функция-член реализует поведение сообщения TB_SETINSERTMARKCOLORWin32, как описано в пакете SDK для Windows.

CToolBarCtrl::SetMaxTextRows

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

BOOL SetMaxTextRows(int iMaxRows);

Параметры

iMaxRows
Максимальное количество строк, которые необходимо задать.

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

Ненулевое значение в случае успеха, иначе — 0.

CToolBarCtrl::SetMetrics

Задает метрики CToolBarCtrl объекта.

void SetMetrics(LPTBMETRICS ptbm);

Параметры

ptbm
Указатель на TBMETRICS структуру CToolBarCtrl объекта.

Замечания

Эта функция-член эмулирует функциональные возможности TB_SETMETRICS сообщения, как описано в пакете SDK для Windows.

CToolBarCtrl::SetOwner

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

void SetOwner(CWnd* pWnd);

Параметры

pWnd
Указатель на объект или CWndпроизводный CWnd от него объект, который будет новым окном владельца для элемента управления панелью инструментов.

Замечания

Окно владельца — это окно, которое получает уведомления с панели инструментов.

CToolBarCtrl::SetPadding

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

DWORD SetPadding(
    int nHorzPadding,
    int nVertPadding);

Параметры

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

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

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

Низкое DWORD слово, содержащее предыдущее горизонтальное заполнение, и высокое слово которого содержит предыдущее вертикальное заполнение. Значения заполнения измеряются в пикселях.

Замечания

Этот метод отправляет TB_SETPADDING сообщение, описанное в пакете SDK для Windows.

Пример

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

{
   // Set the horizontal and vertical padding of the current
   // toolbar control.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetPadding(50, 50);
}

CToolBarCtrl::SetPressedImageList

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

CImagelist* SetPressedImageList(
    int iImageID,
    CImageList* pImageList);

Параметры

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

pImageList
[in] Указатель на CImageList объект, содержащий новый список изображений.

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

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

Замечания

Этот метод отправляет TB_SETPRESSEDIMAGELIST сообщение, описанное в пакете SDK для Windows.

Пример

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

{
   // SetPressedImageList
   // Set the pressed image list to be the same as the
   // normal image list.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   CImageList *pNormalCil = m_toolBarCtrl.GetImageList();
   CImageList *pPressedCil = m_toolBarCtrl.GetPressedImageList();
   m_toolBarCtrl.SetPressedImageList(0, pNormalCil);
}

CToolBarCtrl::SetRows

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

void SetRows(
    int nRows,
    BOOL bLarger,
    LPRECT lpRect);

Параметры

nRows
Запрошено количество строк.

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

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

Замечания

Если панель инструментов не может изменить размер запрошенного числа или строк, она изменит размер до следующего большего или следующего меньшего допустимого размера в зависимости от значения bLarger. Если bLarger это TRUEтак, новое число строк будет больше, чем запрошенное число. Если bLarger это FALSEтак, новое число строк будет меньше запрошенного числа.

Заданное количество строк допустимо для панели инструментов, если кнопки можно упорядочить таким образом, чтобы все строки имели одинаковое количество кнопок (за исключением последней строки). Например, панель инструментов, содержащая четыре кнопки, не может быть размером до трех строк, так как последние две строки должны быть короче. Если вы попытались размерить его до трех строк, вы получите четыре строки, если bLarger это было TRUE и две строки bLarger FALSE.

Если на панели инструментов есть разделители, правила, если заданное количество строк является допустимым, более сложны. Макет вычисляется таким образом, что группы кнопок (кнопки с разделителем до первой и последней кнопки в группе) никогда не разбиваются на несколько строк, если только группа не не может поместиться в одну строку.

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

Обратите внимание, что SetRows функция-член всегда будет выбирать макет, который приводит к наименьшей размеру панели инструментов. Создание панели инструментов с TBSTYLE_WRAPABLE помощью стиля и изменение размера элемента управления просто применит метод, описанный выше, с учетом ширины элемента управления.

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

CToolBarCtrl::SetState

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

BOOL SetState(
    int nID,
    UINT nState);

Параметры

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

nState
Флаги состояния. Это может быть сочетание значений, перечисленных для состояний кнопки в CToolBarCtrl::AddButtons.

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

Эта функция особенно удобна, если вы хотите задать несколько состояний кнопки. Чтобы только задать одно состояние, используйте одну из следующих функций-членов: EnableButton, , CheckButton, HideButtonIndeterminateили PressButton.

CToolBarCtrl::SetStyle

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

void SetStyle(DWORD dwStyle);

Параметры

dwStyle
Сочетание DWORD стилей элементов управления панели инструментов, как описано в пакете SDK для Windows.

CToolBarCtrl::SetToolTips

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

void SetToolTips(CToolTipCtrl* pTip);

Параметры

pTip
Указатель на CToolTipCtrl объект.

CToolBarCtrl::SetWindowTheme

Задает визуальный CToolBarCtrl стиль объекта.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Параметры

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

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

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

Замечания

Эта функция-член эмулирует функциональные возможности TB_SETWINDOWTHEME сообщения, как описано в пакете SDK для Windows.

См. также

Пример MFC CMNCTRL1
Пример MFC MFCIE
CWnd Класс
Диаграмма иерархии
CToolBar Класс