Структура THUMBBUTTON (shobjidl_core.h)
Используется методами интерфейса 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