Přidání položek do seznamu odkazů Windows

Seznam odkazů je kontextová nabídka, kterou systém Windows zobrazí, když uživatel klikne pravým tlačítkem myši na ikonu vaší aplikace na hlavním panelu nebo v nabídce Start. Do seznamu pro přechod můžete přidat úlohy – rychlé akce v celé aplikaci, jako je vytvoření nové zprávy nebo otevření nastavení – a vlastní skupiny položek, jako jsou nedávné projekty nebo připnuté dokumenty.

Otevřete aplikaci Galerie WinUI a podívejte se na JumpList v akci.

Important

Rozhraní JUMPList API vyžaduje identitu balíčku. Funguje v balených aplikacích (MSIX) a v aplikacích balených do externího umístění, ale není k dispozici v nebalených aplikacích.

Předpoklady

Načtení aktuálního seznamu přeskakování

Před přidáním nebo odebráním položek načtěte aktuální seznam přeskakování aplikace voláním JumpList.LoadCurrentAsync:

using Windows.UI.StartScreen;

var jumpList = await JumpList.LoadCurrentAsync();

Přidání úkolů

Úkoly jsou položky s prázdnou GroupName vlastností. Windows je umístí do integrované části Úkoly v dolní části seznamu zkratek. Používejte úlohy pro běžné akce, které jsou vždy relevantní bez ohledu na kontext.

Vytvořte úlohu s jumpListItem.CreateWithArguments, přidejte ji do kolekce Items a pak ji uložte voláním JumpList.SaveAsync. Když uživatel vybere úlohu, Windows spustí aplikaci s řetězcem argumentu, který jste zadali, který můžete číst z argumentů aktivace při spuštění.

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

Přidání položek do vlastní skupiny

Vlastní skupiny umožňují uspořádat související položky pod pojmenovaným nadpisem. Nastavte vlastnost GroupName na neprázdný řetězec; všechny položky se stejným GroupName se zobrazí společně pod touto hlavičkou.

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

Vymazat všechny položky

Pokud chcete odebrat všechny položky, které jste přidali, zrušte před uložením kolekci Položky :

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

Windows bez ohledu na toto volání zachová oddíly spravované systémem (například Nedávné a Časté). Vymažou se jenom vaše vlastní úlohy a skupiny.

  • Last updated on