Lägg till objekt i snabblistan i Windows

En snabblista är snabbmenyn som Windows visas när en användare högerklickar på appens ikon i aktivitetsfältet eller på Start-menyn. Du kan fylla i snabblistan med uppgifter – snabba appomfattande åtgärder som att skapa ett nytt meddelande eller öppna inställningar – och med anpassade grupper av objekt, till exempel senaste projekt eller fästa dokument.

Öppna WinUI-galleriappen och se JumpList i praktiken

Important

JumpList-API:et kräver paketidentitet. Det fungerar i paketerade (MSIX)-appar och appar som paketeras med extern plats, men är inte tillgängligt i opackade appar.

Förutsättningar

Ladda den aktuella jumplistan

Innan du lägger till eller tar bort objekt läser du in appens aktuella snabblista genom att anropa JumpList.LoadCurrentAsync:

using Windows.UI.StartScreen;

var jumpList = await JumpList.LoadCurrentAsync();

Lägga till uppgifter

Aktiviteter är objekt med en tom GroupName egenskap. Windows placerar dem i ett inbyggt aktivitetsavsnitt längst ned i hopplistan. Använd uppgifter för vanliga åtgärder som alltid är relevanta oavsett kontext.

Skapa en uppgift med JumpListItem.CreateWithArguments, lägg till den i samlingen Objekt och spara sedan genom att anropa JumpList.SaveAsync. När användaren väljer uppgiften startar Windows appen med den argumentsträng som du angav, som du kan läsa från aktiveringsargumenten vid start.

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();

Lägga till objekt i en anpassad grupp

Med anpassade grupper kan du ordna relaterade objekt under en namngiven rubrik. Ange egenskapen GroupName till en sträng som inte är tom. alla objekt som delar samma GroupName visas tillsammans under den rubriken.

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();

Rensa alla objekt

Ta bort alla objekt som du har lagt till genom att rensa samlingen Objekt innan du sparar:

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

Windows bevarar de systemhanterade avsnitten (till exempel Senaste och Frekvent) oavsett det här anropet. Endast dina anpassade uppgifter och grupper rensas.

  • Last updated on