Структура THUMBBUTTON (shobjidl_core.h)

Статья
08/26/2023

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

Синтаксис

typedef struct THUMBBUTTON {
  THUMBBUTTONMASK  dwMask;
  UINT             iId;
  UINT             iBitmap;
  HICON            hIcon;
  WCHAR            szTip[260];
  THUMBBUTTONFLAGS dwFlags;
} THUMBBUTTON, *LPTHUMBBUTTON;

Члены

dwMask

Тип: THUMBBUTTONMASK

Сочетание значений THUMBBUTTONMASK , указывающих, какие элементы этой структуры содержат допустимые данные; Другие элементы игнорируются, за исключением iId, который всегда является обязательным.

iId

Тип: UINT

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

iBitmap

Тип: UINT

Отсчитываемый от нуля индекс изображения кнопки в списке изображений, заданный с помощью ITaskbarList3::ThumbBarSetImageList.

hIcon

Тип: HICON

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

szTip[260]

Тип: WCHAR[260]

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

dwFlags

Тип: THUMBBUTTONFLAGS

Сочетание значений THUMBBUTTONFLAGS , управляющих определенными состояниями и поведением кнопки.

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

Изображения кнопок

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

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

Приложения должны предоставлять следующие образы кнопок:

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

Изображения должны быть 32-разрядными и иметь измерения GetSystemMetrics(SM_CXICON) x GetSystemMetrics(SM_CYICON). Сама панель инструментов предоставляет визуальные элементы для состояний нажатия, отключения и наведения кнопки.

Требования


Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Верхняя часть	shobjidl_core.h (включая Shobjidl.h)

См. также раздел

ITaskbarList3::ThumbBarAddButtons

ITaskbarList3::ThumbBarUpdateButtons

Расширения панели задач

Пример: панель инструментов эскизов на панели задач

Share via