JumpList-Klasse

Stellt eine Liste von Elementen und Aufgaben dar, die auf einer Windows 7-Taskleistenschaltfläche als Menü angezeigt werden.

Vererbungshierarchie

System.Object
  Microsoft.Windows.Shell.JumpList

Namespace:  Microsoft.Windows.Shell
Assembly:  Microsoft.Windows.Shell (in Microsoft.Windows.Shell.dll)

Syntax

'Declaration
<ContentPropertyAttribute("JumpItems")> _
Public NotInheritable Class JumpList _
    Implements ISupportInitialize

[ContentPropertyAttribute("JumpItems")]
public sealed class JumpList : ISupportInitialize

[ContentPropertyAttribute(L"JumpItems")]
public ref class JumpList sealed : ISupportInitialize

[<Sealed>]
[<ContentPropertyAttribute("JumpItems")>]
type JumpList =  
    class
        interface ISupportInitialize
    end

public final class JumpList implements ISupportInitialize

Der JumpList-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	JumpList()	Initialisiert eine neue Instanz der JumpList-Klasse.
	JumpList(IEnumerable<JumpItem>, Boolean, Boolean)	Initialisiert eine neue Instanz der JumpList-Klasse mit den angegebenen Parametern.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	JumpItems	Ruft die Auflistung von JumpItem-Objekten, die in der Sprungliste angezeigt werden, ab.
	ShowFrequentCategory	Ruft einen Wert ab, der angibt, ob häufig verwendete Elemente in der Sprungliste angezeigt werden, oder legt ihn fest.
	ShowRecentCategory	Ruft einen Wert ab, der angibt, ob zuletzt verwendete Elemente in der Sprungliste angezeigt werden, oder legt ihn fest.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	AddToRecentCategory(String)	Fügt der Kategorie Aktuell der Sprungliste den angegebenen Elementpfad hinzu.
	AddToRecentCategory(JumpPath)	Fügt der Kategorie Aktuell der Sprungliste den angegebenen Sprungpfad hinzu.
	AddToRecentCategory(JumpTask)	Fügt der Kategorie Aktuell der Sprungliste die angegebene Sprungaufgabe hinzu.
	Apply	Sendet das JumpList-Objekt in seinem aktuellen Zustand an die Windows-Shell.
	BeginInit	Infrastruktur. Signalisiert den Beginn der JumpList-Initialisierung.
	EndInit	Infrastruktur. Signalisiert das Ende der JumpList-Initialisierung.
	Equals	Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetJumpList	Gibt das mit einer Anwendung verknüpfte JumpList-Objekt zurück.
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	SetJumpList	Legt das einer Anwendung zugeordnete JumpList-Objekt fest.
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	JumpItemsRejected	Tritt auf, wenn beim Hinzufügen von Sprungelementen zur Sprungliste durch die Windows-Shell ein Fehler aufgetreten ist.
	JumpItemsRemovedByUser	Tritt auf, wenn Sprungelemente, die zuvor in der Sprungliste enthalten waren, vom Benutzer aus der Liste entfernt werden.

Zum Seitenanfang

Hinweise

Die Windows 7-Taskleiste stellt die verbesserte Funktionalität bereit, um Programme direkt mit Sprunglisten von der Schaltfläche der Taskleiste zu starten. Sprunglisten werden auch im Windows 7-Startmenü verwendet. Sie greifen auf eine Sprungliste zu, indem Sie mit der rechten Maustaste auf eine Schaltfläche der Taskleiste oder auf den Pfeil neben einem Programm im Startmenü klicken. Weitere Informationen zu Sprunglisten finden Sie im Abschnitt Taskleiste der Windows User Experience Interaction Guidelines.

Die JumpList-Klasse bietet einen verwalteten Wrapper für die Sprunglistenfunktion der Windows 7-Taskleiste und verwaltet die Daten, die an die Windows-Shell übergeben werden. Die von der JumpList-Klasse bereitgestellte Funktionalität ist in Versionen von Windows vor Windows 7 nicht verfügbar. Anwendungen, die die JumpList-Klasse verwenden, werden in anderen Versionen von Windows ausgeführt, aber die Sprungliste ist nicht verfügbar. Weitere Informationen zur Windows-Shell und den nativen Sprunglisten-APIs finden Sie unter Taskleistenerweiterungen..

Die folgende Abbildung zeigt die Sprungliste für Windows Media Player, mit Elementen in den Kategorien Aufgaben und Häufig, an.

Windows Media Player-Sprungliste

Konfigurieren einer Sprungliste

Sprunglisten können zwei Typen von Elementen enthalten, ein JumpTask und ein JumpPath. Ein JumpTask ist ein Link zu einem Programm, und ein JumpPath ist ein Link zu einer Datei. Sie können Elemente in einer Sprungliste visuell trennen, indem Sie einen JumpTask erstellen, für den kein Title und keine CustomCategory angegeben ist. Dieser leere JumpTask wird als horizontale Linie in der Sprungliste angezeigt.

Hinweis
Wenn der Dateityp, der in einem JumpPath-Objekt angegeben ist, nicht für Ihre Anwendung registriert ist, wird die Datei nicht in der Sprungliste.Wenn Sie z. B. einen JumpPath hinzufügen, der auf eine TXT-Datei zeigt, muss die Anwendung zum Verarbeiten von TXT-Dateien registriert werden.Weitere Informationen finden Sie unter Introduction to File Associations.

Sprungelemente werden in Kategorien im JumpList eingefügt. Standardmäßig wird ein JumpItem-Element in der Kategorie Aufgaben angezeigt. Alternativ können Sie einen CustomCategory für JumpItem angeben.

Sie können angeben, ob die Standardkategorien Zuletzt verwendet und Häufig in der JumpList angezeigt werden, indem Sie die ShowRecentCategory-Eigenschaft und ShowFrequentCategory-Eigenschaft festlegen. Der Inhalt dieser Kategorien wird von der Windows-Shell verwaltet. Da diese Kategorien viel von den gleichen Daten enthalten könnten, zeigen Sie einen im JumpList an, aber nicht beide. Windows verwaltet letzte Elemente automatisch, wenn sie über ein allgemeines Dateidialogfeld geöffnet werden oder aber verwendet werden, um per Dateitypzuordnung eine Anwendung zu öffnen. Wenn auf ein Element über die Sprungliste zugegriffen wird, können Sie die Windows-Shell benachrichtigen, dass der Kategorie Zuletzt verwendet das Element durch Aufrufen der AddToRecentCategory-Methode hinzugefügt werden soll.

Übernehmen einer Sprungliste für die Windows-Shell

Sie können nicht auf die Sprungliste der Shell direkt zugreifen oder deren Inhalt in die JumpList-Klasse einlesen. Stattdessen stellt die JumpList-Klasse eine Darstellung einer Sprungliste bereit, mit der Sie arbeiten können, und gilt dann für die Windows-Shell. Sie erstellen in der Regel eine JumpList und legen sie einmal fest, wenn die Anwendung zuerst ausgeführt wird. Sie können jedoch JumpList zur Laufzeit ändern oder ersetzen.

Wenn Sie die JumpList-Eigenschaften festgelegt haben, müssen Sie den JumpList für die Windows-Shell übernehmen, bevor ihr Inhalt in der Taskleistensprungliste angezeigt wird. Dies erfolgt automatisch, wenn die JumpList an eine Anwendung angefügt wird, entweder in XAML oder in einem Aufruf der SetJumpList-Methode. Wenn Sie zur Laufzeit den Inhalt von JumpList ändern, müssen Sie die Apply-Methode aufrufen, um seinen aktuellen Inhalt für die Windows-Shell zu übernehmen.

Festlegen einer Sprungliste in XAML

Ein JumpList-Element ist nicht automatisch einem Application-Objekt zugeordnet. Sie fügen eine JumpList an ein Application-Objekt in XAML an, indem Sie die Syntax der angefügten Eigenschaft verwenden. Die JumpList-Klasse implementiert die ISupportInitialize-Schnittstelle zur Unterstützung der XAML-Deklaration einer JumpList. Wenn der JumpList in XAML deklariert wird und dem aktuellen Application zugewiesen wird, wird er automatisch für die Windows-Shell übernommen, wenn der JumpList initialisiert wird.

Festlegen und Ändern einer Sprungliste in Code

Sie fügen eine JumpList an ein Application-Objekt an, indem Sie die statische SetJumpList-Methode aufrufen. Damit wird auch die JumpList auf die Windows-Shell angewendet.

Um zur Laufzeit eine JumpList zu ändern, rufen Sie die GetJumpList-Methode auf, um die JumpList abzurufen, der gerade an einem Application befestigt ist. Nachdem Sie die Eigenschaften von JumpList geändert haben, müssen Sie die Apply-Methode aufrufe, um die Änderungen auf die Windows-Shell zu übernehmen.

Hinweis
Sie erstellen in der Regel eine JumpList, die an die Application angefügt wird und für die Windows-Shell übernommen wird.Sie können jedoch mehrere JumpList-Objekte erstellen.Nur ein JumpList zu einer Zeit kann für die Windows-Shell und nur jeweils ein JumpList-Objekt können einemApplication-Element zugeordnet sein..NET Framework erfordert nicht, dass diese JumpList entsprechen.

Hinweis
Diese Klasse enthält einen Linkaufruf auf der Klassenebene, der für alle Member gilt.Eine SecurityException wird ausgelöst, wenn der unmittelbare Aufrufer über keine Berechtigung mit vollständiger Vertrauenswürdigkeit verfügt.Weitere Informationen zu Sicherheitsanforderungen finden Sie unter Verknüpfungsaufrufe und unter Vererbungsforderungen.

.NET Framework-Sicherheit

• UIPermission 

  für Vollzugriff, um die Windows-Shell zu ändern. Sicherheitsaktion: LinkDemand. Zugeordnete Enumeration: UIPermissionWindow.AllWindows

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

Microsoft.Windows.Shell-Namespace