Ajouter des éléments à la liste de raccourcis Windows

Une liste de raccourcis est le menu contextuel qui Windows s'affiche lorsqu'un utilisateur clique avec le bouton droit sur l'icône de votre application dans la barre des tâches ou dans le menu Démarrer. Vous pouvez remplir la liste de raccourcis avec des tâches ( actions rapides à l’échelle de l’application, telles que la composition d’un nouveau message ou l’ouverture de paramètres) et avec des groupes personnalisés d’éléments tels que des projets récents ou des documents épinglés.

Ouvrez l’application Galerie WinUI et consultez JumpList en action

Important

L’API JumpList nécessite une identité de package. Il fonctionne dans les applications empaquetées (MSIX) et les applications empaquetées avec un emplacement externe, mais elles ne sont pas disponibles dans les applications non empaquetées.

Prerequisites

Charger la liste de raccourcis actuelle

Avant d’ajouter ou de supprimer des éléments, chargez la liste de raccourcis actuelle de l’application en appelant JumpList.LoadCurrentAsync :

using Windows.UI.StartScreen;

var jumpList = await JumpList.LoadCurrentAsync();

Ajouter des tâches

Les tâches sont des éléments avec une propriété vide GroupName . Windows les place dans une section Tâches intégrées en bas de la liste de raccourcis. Utilisez des tâches pour les actions courantes qui sont toujours pertinentes, quel que soit le contexte.

Créez une tâche avec JumpListItem.CreateWithArguments, ajoutez-la à la collection Items , puis enregistrez-la en appelant JumpList.SaveAsync. Lorsque l’utilisateur sélectionne la tâche, Windows lance votre application avec la chaîne d’argument que vous avez fournie, que vous pouvez lire à partir des arguments d’activation au démarrage.

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

Ajouter des éléments à un groupe personnalisé

Les groupes personnalisés vous permettent d’organiser les éléments associés sous un titre nommé. Définissez la propriété GroupName sur une chaîne non vide ; tous les éléments qui partagent les mêmes GroupName apparaissent ensemble sous ce titre.

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

Effacer tous les éléments

Pour supprimer tous les éléments que vous avez ajoutés, effacez la collection Items avant d’enregistrer :

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

Windows conserve les sections gérées par le système (telles que Récentes et fréquentes), quel que soit cet appel ; seules vos tâches et groupes personnalisés sont effacées.

  • Last updated on