Elemek hozzáadása a Windows ugrólistához

A ugrólista az a helyi menü, amelyet a Windows jelenít meg, amikor a felhasználó a jobb gombbal kattint az alkalmazás ikonjára a tálcán vagy a Start menüben. A gyorslistát feltöltheti feladatokkal – gyorsalkalmazás-szintű műveletekkel, például új üzenet írásával vagy a beállítások megnyitásával –, valamint egyéni elemcsoportokkal , például legutóbbi projektekkel vagy rögzített dokumentumokkal.

Nyissa meg a WinUI Gallery alkalmazást, és tekintse meg a JumpList működését

Important

A JumpList API csomagidentitást igényel. Működik a csomagolt (MSIX-)alkalmazásokban és a külső hellyel csomagolt alkalmazásokban, de a csomagolatlan alkalmazásokban nem érhető el.

Prerequisites

  • Az alkalmazásnak csomagazonosítóval kell rendelkeznie: msIX-sel csomagolva vagy külső helyen csomagolva. A csomagolatlan alkalmazások nem támogatottak.
  • Cél Windows 10, 1607-es verzió (évfordulós frissítés, 14393-es build) vagy újabb.

Az aktuális ugrási lista betöltése

Elemek hozzáadása vagy eltávolítása előtt töltse be az alkalmazás aktuális jumplistáját a JumpList.LoadCurrentAsync meghívásával:

using Windows.UI.StartScreen;

var jumpList = await JumpList.LoadCurrentAsync();

Tevékenységek hozzáadása

A feladatok olyan elemek, amelyek üres GroupName tulajdonsággal rendelkeznek. Windows a ugrólista alján található beépített Feladatok szakaszba helyezi őket. Olyan gyakori műveletekhez használjon feladatokat, amelyek a környezettől függetlenül mindig relevánsak.

Hozzon létre egy feladatot a JumpListItem.CreateWithArguments használatával, adja hozzá az Elemek gyűjteményhez, majd mentse a JumpList.SaveAsync meghívásával. Amikor a felhasználó kiválasztja a feladatot, Windows elindítja az alkalmazást a megadott argumentumsztringgel, amelyet az indításkor az aktiválási argumentumokból olvashat.

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

Elemek hozzáadása egyéni csoporthoz

Az egyéni csoportok lehetővé teszik a kapcsolódó elemek rendszerezését egy elnevezett címsor alatt. Állítsa a GroupName tulajdonságot egy nem üres karakterláncra; az összes, azonos GroupName értékkel rendelkező elem együtt jelenik meg az adott címsor alatt.

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

Az összes elem törlése

Az összes hozzáadott elem eltávolításához mentse az Elemek gyűjteményt a mentés előtt:

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

Windows a hívástól függetlenül megőrzi a rendszer által felügyelt szakaszokat (például a Legutóbbi és a Gyakori szakaszokat), csak az egyéni tevékenységek és csoportok törlődnek.

  • Last updated on