Hinzufügen von Elementen zur Windows Sprungliste

Eine Sprungliste ist das Kontextmenü, das Windows anzeigt, wenn ein Benutzer mit der rechten Maustaste auf das Symbol Ihrer App auf der Taskleiste oder im Startmenü klickt. Sie können die Sprungliste mit Aufgaben auffüllen – schnelle appweite Aktionen wie das Verfassen einer neuen Nachricht oder die Öffnen von Einstellungen – und mit benutzerdefinierten Gruppen von Elementen wie zuletzt verwendeten Projekten oder angehefteten Dokumenten.

Öffnen Sie die WinUI Gallery-App, und sehen Sie "JumpList" in Aktion.

Important

Für die JumpList-API ist eine Paketidentität erforderlich. Es funktioniert in paketierten (MSIX-)Apps und in Apps mit externem Speicherort, ist jedoch für nicht paketierte Apps nicht verfügbar.

Voraussetzungen

Aktuelle Sprungliste laden

Laden Sie vor dem Hinzufügen oder Entfernen von Elementen die aktuelle Sprungliste der App durch Aufrufen von JumpList.LoadCurrentAsync:

using Windows.UI.StartScreen;

var jumpList = await JumpList.LoadCurrentAsync();

Hinzufügen von Aufgaben

Aufgaben sind Elemente mit einer leeren GroupName Eigenschaft. Windows platziert sie in einem integrierten Aufgabenabschnitt am unteren Rand der Sprungliste. Verwenden Sie Aufgaben für allgemeine Aktionen, die unabhängig vom Kontext immer relevant sind.

Erstellen Sie eine Aufgabe mit JumpListItem.CreateWithArguments, fügen Sie sie der Items-Auflistung hinzu, und speichern Sie dann durch Aufrufen von JumpList.SaveAsync. Wenn der Benutzer die Aufgabe auswählt, startet Windows Ihre App mit der angegebenen Argumentzeichenfolge, die Sie beim Start aus den Aktivierungsargumenten lesen können.

var jumpList = await JumpList.LoadCurrentAsync();

var task = JumpListItem.CreateWithArguments("/compose", "New Message");
task.Description = "Compose a new message";
task.Logo = new Uri("ms-appx:///Assets/Tiles/AppList.targetsize-48.png");

jumpList.Items.Add(task);
await jumpList.SaveAsync();

Hinzufügen von Elementen zu einer benutzerdefinierten Gruppe

Mit benutzerdefinierten Gruppen können Sie verwandte Elemente unter einer benannten Überschrift organisieren. Legen Sie die GroupName-Eigenschaft auf eine nicht leere Zeichenfolge fest; alle Elemente, die dasselbe GroupName teilen, werden unter dieser Überschrift zusammen angezeigt.

var jumpList = await JumpList.LoadCurrentAsync();

var item = JumpListItem.CreateWithArguments("/project-alpha", "Project Alpha");
item.GroupName = "Projects";
item.Description = "Open Project Alpha";
item.Logo = new Uri("ms-appx:///Assets/Tiles/AppList.targetsize-48.png");

jumpList.Items.Add(item);
await jumpList.SaveAsync();

Alle Elemente löschen

Um alle hinzugefügten Elemente zu entfernen, löschen Sie die Items-Auflistung vor dem Speichern:

var jumpList = await JumpList.LoadCurrentAsync();
jumpList.Items.Clear();
await jumpList.SaveAsync();

Windows behält die vom System verwalteten Abschnitte (z. B. Zuletztverwendet und häufig) unabhängig von diesem Aufruf bei. Nur Ihre benutzerdefinierten Aufgaben und Gruppen werden gelöscht.

  • Last updated on