Dodawanie elementów do listy skoków Windows

Lista przeskoków to menu podręczne, które system Windows wyświetla, gdy użytkownik kliknie prawym przyciskiem myszy ikonę aplikacji na pasku zadań lub w menu Start. Listę szybkiego dostępu można wypełnić zadaniami — szybkimi działaniami dostępnymi w całej aplikacji, takimi jak utworzenie nowej wiadomości lub otwarcie ustawień — oraz niestandardowymi grupami elementów, takimi jak ostatnie projekty lub przypięte dokumenty.

Otwórz aplikację Galeria WinUI i zobacz JumpList w akcji

Ważna

Interfejs API JumpList wymaga tożsamości pakietu. Działa w aplikacjach w pakiecie (MSIX) oraz aplikacjach spakietowanych z lokalizacją zewnętrzną, ale nie jest dostępna w aplikacjach niespakietowanych.

Prerequisites

Załaduj bieżącą listę skoków

Przed dodaniem lub usunięciem elementów załaduj bieżącą listę skoków aplikacji, wywołując metodę JumpList.LoadCurrentAsync:

using Windows.UI.StartScreen;

var jumpList = await JumpList.LoadCurrentAsync();

Dodawanie zadań

Zadania to elementy z pustą GroupName właściwością. Windows umieszcza je we wbudowanej sekcji Zadania na dole menu szybkiego dostępu. Używaj zadań dla typowych akcji, które są zawsze istotne niezależnie od kontekstu.

Utwórz zadanie za pomocą polecenia JumpListItem.CreateWithArguments, dodaj je do kolekcji Items , a następnie zapisz, wywołując metodę JumpList.SaveAsync. Gdy użytkownik wybierze zadanie, Windows uruchomi aplikację przy użyciu podanego ciągu argumentu, który można odczytać z argumentów aktywacji podczas uruchamiania.

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

Dodaj elementy do grupy niestandardowej

Grupy niestandardowe umożliwiają organizowanie powiązanych elementów pod nazwanym nagłówkiem. Ustaw właściwość GroupName na ciąg niepusty; wszystkie elementy współużytkujące te same GroupName elementy są wyświetlane razem pod tym nagłówkiem.

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

Wyczyść wszystkie elementy

Aby usunąć wszystkie dodane elementy, wyczyść kolekcję Items przed zapisaniem:

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

Windows zachowuje sekcje zarządzane przez system (takie jak Ostatnie i Częste), niezależnie od tego wywołania; czyszczone są tylko niestandardowe zadania i grupy.

  • Last updated on