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


Интерфейс 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

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