ICustomDestinationList-Schnittstelle (shobjidl_core.h)

  • Artikel

Macht Methoden verfügbar, mit denen eine Anwendung eine benutzerdefinierte Sprungliste bereitstellen kann, einschließlich Zielen und Aufgaben, für die Anzeige in der Taskleiste.

Vererbung

Die ICustomDestinationList-Schnittstelle erbt von der IUnknown-Schnittstelle . ICustomDestinationList verfügt auch über die folgenden Typen von Membern:

Methoden

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

 
ICustomDestinationList::AbortList

Beendet eine von ICustomDestinationList::BeginList initiierte Jump List-Erstellungssitzung ohne Commit für Änderungen.
ICustomDestinationList::AddUserTasks

Gibt Elemente an, die in die Kategorie Aufgaben einer benutzerdefinierten Sprungliste aufgenommen werden sollen.
ICustomDestinationList::AppendCategory

Definiert eine benutzerdefinierte Kategorie und die darin enthaltenen Ziele für die Aufnahme in eine benutzerdefinierte Sprungliste.
ICustomDestinationList::AppendKnownCategory

Gibt an, dass die Kategorie Häufig oder Zuletzt in eine benutzerdefinierte Sprungliste aufgenommen werden soll.
ICustomDestinationList::BeginList

Initiiert eine Erstellungssitzung für eine benutzerdefinierte Sprungliste.
ICustomDestinationList::CommitList

Deklariert, dass die Sprungliste, die durch einen Aufruf von ICustomDestinationList::BeginList initiiert wurde, vollständig und zur Anzeige bereit ist.
ICustomDestinationList::D eleteList

Löscht eine benutzerdefinierte Sprungliste für eine angegebene Anwendung.
ICustomDestinationList::GetRemovedDestinations

Ruft die aktuelle Liste der Ziele ab, die vom Benutzer aus der vorhandenen Sprungliste entfernt wurden, die diese benutzerdefinierte Sprungliste ersetzen soll.
ICustomDestinationList::SetAppID

Gibt eine eindeutige Anwendungsbenutzermodell-ID (AppUserModelID) für die Anwendung an, deren Taskleistenschaltfläche die benutzerdefinierte Sprungliste enthält, die über die Methoden dieser Schnittstelle erstellt wurde. Diese Methode ist optional.

Hinweise

Wann muss implementiert werden?

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

Wann sollte verwendet werden?

Jump Listen sowohl Ziel- als auch Aufgabenlisten enthalten.
  • Ziele sind Elemente, die basierend auf der Nutzung einer Person in den Kategorien Zuletzt, Häufig oder benutzerdefinierte Angezeigt werden. Ziele können Dateien, Ordner, Websites oder andere inhaltsbasierte Elemente sein, sind aber nicht unbedingt dateigesichert. Ziele können als Dinge oder Nomen betrachtet werden. Ziele können vom Benutzer angeheftet oder aus der Sprungliste entfernt werden. Sie werden im Allgemeinen durch IShellItem-Objekte dargestellt, können aber auch IShellLink-Objekte sein.
  • Aufgaben sind allgemeine Aktionen, die in einer Anwendung ausgeführt werden und für alle Benutzer dieser Anwendung gelten, unabhängig vom Nutzungsmuster einer Person. Aufgaben können als Aktionen oder Verben betrachtet werden. Aufgaben können nicht angeheftet oder entfernt werden. Sie werden durch IShellLink-Objekte dargestellt.

Die Taskleiste stellt jede Taskleistenschaltfläche mit einer Sprungliste bereit. Standardmäßig enthält eine Sprungliste eine Kategorie Zuletzt verwendet , die für dateibasierte Anwendungen automatisch über SHAddToRecentDocs oder das Dialogfeld "Allgemeine Datei" aufgefüllt wird. Um die Kategorie Zuletzt verwendet durch die Kategorie Häufig zu ersetzen oder eigene benutzerdefinierte Kategorien zu definieren, hinzuzufügen und aufzufüllen, muss eine Anwendung die Methoden dieser Schnittstelle aufrufen. Die Anwendung kann auch ihre eigenen Aufgaben basierend auf der Architektur und der beabsichtigten Verwendung der Anwendung bereitstellen.

Hinweis Eine Anwendung muss ein registrierter Handler für einen Dateityp sein, damit ein Element dieses Typs in seiner Sprungliste angezeigt wird. Es muss jedoch nicht der Standardhandler für diesen Dateityp sein.
 
Eine benutzerdefinierte Sprungliste soll Inhalte darstellen, die die Anwendung basierend auf der vorherigen Verwendung der Anwendung oder durch eine Aktion als wichtig erachtet hat, die angibt, dass ein Element für den Benutzer von Bedeutung ist, z. B. das Hinzufügen eines Elements zu einer Favoritenliste.

Die Anwendung muss dieses Objekt aufrufen, um eine benutzerdefinierte Sprungliste für die Taskleistenbenutzeroberfläche bereitzustellen. Das System fragt die Anwendung nie nach den Informationen ab.

Wenn eine Anwendung eine benutzerdefinierte Sprungliste bereitstellt, übernimmt sie bestimmte Zuständigkeiten für diese Liste. Benutzerdefinierte Kategorien müssen in einer Weise aufgefüllt werden, die mit der beabsichtigten Verwendung einer Sprungliste übereinstimmt. Elemente in der Liste müssen auf Gültigkeit überprüft werden oder fehlerbehaftet sein, wenn sie gelöscht wurden. Wenn der Benutzer ein Element aus der Liste entfernt, muss diese Entfernung berücksichtigt werden.

Eine benutzerdefinierte Sprungliste wird nie wirklich aktualisiert im Sinne einer Änderung von Elementen in einer vorhandenen Liste. Stattdessen wird die alte Liste durch eine neue Liste ersetzt.

Die grundlegende Sequenz von ICustomDestinationList-Methodenaufrufen zum Erstellen und Anzeigen einer benutzerdefinierten Sprungliste lautet wie folgt:

  1. SetAppID (nur erforderlich, wenn eine Anwendung eine eigene AppUserModelID bereitstellt)
  2. BeginList
  3. AppendCategory, AppendKnownCategory, AddUserTasks oder eine beliebige Kombination dieser drei Methoden.
  4. CommitList

Anforderungen

Anforderung Wert
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

Taskleistenerweiterungen