Интерфейс ITaskbarList3 (shobjidl_core.h)

Расширяет возможности ITaskbarList2 , предоставляя методы, поддерживающие унифицированную функцию запуска и переключения кнопок панели задач, добавленную в Windows 7. Эта функция включает представления эскизов и переключение целевых объектов на основе отдельных вкладок в приложении с вкладками, панели инструментов эскизов, наложения уведомлений и состояния, а также индикаторы хода выполнения.

Наследование

Интерфейс ITaskbarList3 наследуется от ITaskbarList2. ITaskbarList3 также содержит следующие типы элементов:

Методы

Интерфейс ITaskbarList3 содержит следующие методы.

ITaskbarList3::RegisterTab Сообщает панели задач о том, что новая вкладка или эскиз документа была предоставлена для отображения во всплывающем элементе группы панели задач приложения.
ITaskbarList3::SetOverlayIcon Применяет наложение к кнопке панели задач для указания состояния приложения или уведомления пользователю.
ITaskbarList3::SetProgressState Задает тип и состояние индикатора хода выполнения, отображаемого на кнопке панели задач.
ITaskbarList3::SetProgressValue Отображает или обновляет индикатор выполнения, размещенный на кнопке панели задач, чтобы показать определенный процент завершения полной операции.
ITaskbarList3::SetTabActive Сообщает панели задач о том, что окно вкладки или документа стало активным.
ITaskbarList3::SetTabOrder Вставляет новый эскиз во всплывающий элемент группы приложения TDI или многодокументного интерфейса (MDI) или перемещает существующий эскиз в новую позицию в группе приложения.
ITaskbarList3::SetThumbnailClip Выбирает часть клиентской области окна для отображения в качестве эскиза этого окна на панели задач.
ITaskbarList3::SetThumbnailTooltip Указывает или обновляет текст подсказки, которая отображается, когда указатель мыши опирается на отдельный эскиз предварительного просмотра во всплывающем элементе кнопки панели задач.
ITaskbarList3::ThumbBarAddButtons Добавляет панель инструментов эскизов с указанным набором кнопок к эскизу окна во всплывающем элементе кнопки панели задач.
ITaskbarList3::ThumbBarSetImageList Указывает список изображений, содержащий изображения кнопок для панели инструментов, внедренной в эскиз окна во всплывающем элементе кнопки панели задач.
ITaskbarList3::ThumbBarUpdateButtons Отображает, включает, отключает или скрывает кнопки на панели инструментов эскизов в соответствии с текущим состоянием окна. Панель инструментов эскизов — это панель инструментов, внедренная в эскиз окна во всплывающем элементе кнопки панели задач.
ITaskbarList3::UnregisterTab Удаляет эскиз из группы предварительного просмотра приложения при закрытии этой вкладки или документа в приложении.

Комментарии

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

Когда следует реализовать

Реализация этого интерфейса предоставляется в Windows в виде CLSID_TaskbarList. Этот интерфейс не реализуется сторонними производителями.

Когда следует использовать

Используйте методы этого интерфейса для выполнения следующих действий:

• При работе с приложением TDI (например, Windows Internet Обозреватель) или приложением MDI (например, Microsoft Excel), которое отображает свои окна в виде группы на панели задач:
  • Предоставьте на панели задач эскиз, представляющий представление отдельной вкладки или документа.
  • Удалите эскиз отдельной вкладки или документа из группы.
  • Изменение порядка эскизов в группе.
  • Задайте эскиз вкладки в качестве выбранного элемента при отображении эскизов.
• При применении наложения к значку панели задач, например к уведомлению.
• При отображении хода выполнения операции, например копирования или установки элемента.
• При добавлении панели инструментов в эскиз.

Когда приложение отображает окно, его кнопка панели задач создается системой. Когда кнопка на месте, панель задач отправляет в окно сообщение TaskbarButtonCreated . Приложение должно вызвать RegisterWindowMessage(L"TaskbarButtonCreated") и обработать это сообщение в своем wndproc. Это сообщение должно быть получено приложением перед вызовом любого метода ITaskbarList3 .

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

 

Требования

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

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

ITaskbarList2

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