ITaskbarList3-Schnittstelle (shobjidl_core.h)

Erweitert ITaskbarList2 durch Das Verfügbarmachen von Methoden, die die in Windows 7 hinzugefügte funktionen des einheitlichen Startens und Wechselns von Taskleistenschaltflächen unterstützen. Diese Funktionalität umfasst Miniaturansichten und Umschaltziele basierend auf einzelnen Registerkarten in einer Anwendung im Registerkartenformat, Miniaturansichtssymbolleisten, Benachrichtigungen und status-Überlagerungen sowie Statusindikatoren.

Vererbung

Die ITaskbarList3-Schnittstelle erbt von ITaskbarList2. ITaskbarList3 verfügt auch über folgende Membertypen:

Methoden

Die ITaskbarList3-Schnittstelle verfügt über diese Methoden.

ITaskbarList3::RegisterTab Informiert die Taskleiste darüber, dass eine neue Registerkarten- oder Dokumentminiaturansicht zur Anzeige im Taskleistengruppen-Flyout einer Anwendung bereitgestellt wurde.
ITaskbarList3::SetOverlayIcon Wendet eine Überlagerung auf eine Taskleistenschaltfläche an, um die Anwendung status oder eine Benachrichtigung für den Benutzer anzugeben.
ITaskbarList3::SetProgressState Legt den Typ und zustand des Statusindikators fest, der auf einer Taskleistenschaltfläche angezeigt wird.
ITaskbarList3::SetProgressValue Zeigt eine Statusleiste an, die in einer Taskleistenschaltfläche gehostet wird, um den bestimmten Prozentsatz des vollständigen Vorgangs anzuzeigen.
ITaskbarList3::SetTabActive Informiert die Taskleiste darüber, dass ein Registerkarten- oder Dokumentfenster zum aktiven Fenster gemacht wurde.
ITaskbarList3::SetTabOrder Fügt eine neue Miniaturansicht in das Gruppenflyout einer MDI- oder MDI-Anwendung (Tabbed Document Interface) ein oder verschiebt eine vorhandene Miniaturansicht an eine neue Position in der Gruppe der Anwendung.
ITaskbarList3::SetThumbnailClip Wählt einen Teil des Clientbereichs eines Fensters aus, der als Miniaturansicht dieses Fensters auf der Taskleiste angezeigt werden soll.
ITaskbarList3::SetThumbnailTooltip Gibt den Text der QuickInfo an, der angezeigt wird, wenn der Mauszeiger auf einer einzelnen Vorschauansicht in einem Flyout der Taskleistenschaltfläche ruht, oder aktualisiert diesen.
ITaskbarList3::ThumbBarAddButtons Fügt dem Miniaturansichtsbild eines Fensters in einem Taskleistenschaltflächen-Flyout eine Miniaturansicht mit einem angegebenen Satz von Schaltflächen hinzu.
ITaskbarList3::ThumbBarSetImageList Gibt eine Bildliste an, die Schaltflächenbilder für eine Symbolleiste enthält, die in ein Miniaturbild eines Fensters in einem Flyout der Taskleistenschaltfläche eingebettet ist.
ITaskbarList3::ThumbBarUpdateButtons Zeigt Schaltflächen in einer Miniaturansichtssymbolleiste an, aktiviert, deaktiviert oder blendet sie aus, wie es für den aktuellen Zustand des Fensters erforderlich ist. Eine Miniaturansichtssymbolleiste ist eine Symbolleiste, die in ein Miniaturansichtsbild eines Fensters in einem Taskleistenschaltfläche-Flyout eingebettet ist.
ITaskbarList3::UnregisterTab Entfernt eine Miniaturansicht aus der Vorschaugruppe einer Anwendung, wenn diese Registerkarte oder das Dokument in der Anwendung geschlossen wird.

Hinweise

Diese Schnittstelle stellt auch die Methoden der Schnittstellen ITaskbarList und ITaskbarList2 bereit, von denen sie erbt.

Wann muss implementiert werden?

Eine Implementierung dieser Schnittstelle wird in Windows als CLSID_TaskbarList bereitgestellt. Diese Schnittstelle wird nicht von Drittanbietern implementiert.

Wann sollte verwendet werden?

Verwenden Sie die Methoden dieser Schnittstelle, um Folgendes zu tun:

• Wenn Sie mit einer TDI-Anwendung (z. B. Windows Internet Explorer) oder einer MDI-Anwendung (z. B. Microsoft Excel) arbeiten, die ihre Fenster als Gruppe auf der Taskleiste anzeigt:
  • Stellen Sie die Taskleiste mit einer Miniaturansicht bereit, die die Ansicht einer einzelnen Registerkarte oder eines einzelnen Dokuments darstellt.
  • Entfernen Sie die Miniaturansicht einer einzelnen Registerkarte oder eines dokuments aus der Gruppe.
  • Ändern Sie die Reihenfolge der Miniaturansichten in der Gruppe.
  • Legen Sie eine Registerkartenminiaturansicht als ausgewähltes Element fest, wenn die Miniaturansichten angezeigt werden.
• Beim Anwenden eines Overlays auf ein Taskleistensymbol, z. B. eine Benachrichtigung.
• Wenn der Fortschritt eines Vorgangs angezeigt wird, z. B. das Kopieren oder Installieren eines Elements.
• Beim Hinzufügen einer Symbolleiste zu einer Miniaturansicht.

Wenn eine Anwendung ein Fenster anzeigt, wird die Taskleistenschaltfläche vom System erstellt. Wenn die Schaltfläche vorhanden ist, sendet die Taskleiste eine TaskbarButtonCreated-Nachricht an das Fenster. Ihre Anwendung sollte RegisterWindowMessage(L"TaskbarButtonCreated") aufrufen und diese Nachricht in ihrem wndproc behandeln. Diese Nachricht muss von Ihrer Anwendung empfangen werden, bevor sie eine ITaskbarList3-Methode aufruft.

Hinweis Anwendungen können sich nicht programmgesteuert an die Taskleiste anheften. Diese Funktionalität ist ausschließlich für den Benutzer reserviert.

 

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)

Weitere Informationen

ITaskbarList2

Taskleistenerweiterungen