JumpList Classe

  • Référence

Définition

Espace de noms:
Windows.UI.StartScreen
Modifier

Fournit des fonctionnalités pour la liste de raccourcis d’une application. Une liste de raccourcis est un menu fourni par le système qui s’affiche lorsque l’utilisateur clique avec le bouton droit sur un programme dans la barre des tâches ou dans le menu Démarrer. Il est utilisé pour fournir un accès rapide aux documents récemment ou fréquemment utilisés et offrir des liens directs vers les fonctionnalités de l’application. Toutes les familles d’appareils ne prennent pas en charge les listes de raccourcis.

public ref class JumpList sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class JumpList final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class JumpList
Public NotInheritable Class JumpList
Héritage
Object Platform::Object IInspectable JumpList
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v2.0)

Exemples

L’exemple suivant montre comment supprimer la liste de raccourcis d’une application, y compris les éléments personnalisés qui ont pu être ajoutés précédemment.

private async void DisableSystemJumpListAsync()
{
    // Get the app's jump list.
    var jumpList = await Windows.UI.StartScreen.JumpList.LoadCurrentAsync();

    // Disable the system-managed jump list group.
    jumpList.SystemGroupKind = Windows.UI.StartScreen.JumpListSystemGroupKind.None;

    // Remove any previously added custom jump list items.
    jumpList.Items.Clear();

    // Save the changes to the app's jump list.
    await jumpList.SaveAsync();
}

L’exemple suivant montre comment définir le type de groupe géré par le système utilisé par la liste de raccourcis d’une application, sans affecter les éléments de liste de raccourcis personnalisés existants.

private async void SetSystemGroupAsync()
{
    // Get the app's jump list.
    var jumpList = await Windows.UI.StartScreen.JumpList.LoadCurrentAsync();

    // Set the system to autogenerate a Frequent group for the app jump list.
    // Alternatively, this property could be set to JumpListSystemGroupKind.Recent to autogenerate a Recent group.
    jumpList.SystemGroupKind = Windows.UI.StartScreen.JumpListSystemGroupKind.Frequent;

    // No changes were made to the jump list Items property, so any custom tasks and groups remain intact.
    await jumpList.SaveAsync();
}

Remarques

La liste JumpList d’une application est récupérée à l’aide de la méthode LoadCurrentAsync . Si une application ne personnalise pas sa liste de raccourcis, le système fournit une liste de raccourcis par défaut. Actuellement, la liste de raccourcis par défaut affiche les éléments récents. Assurez-vous que votre application s’est inscrite pour devenir le gestionnaire de fichiers par défaut pour un certain type de fichier que vous souhaitez afficher dans la liste des éléments récents. Pour plus d’informations, consultez Gérer l’activation des fichiers.

Propriétés

Items

Obtient la liste des JumpListItem pour la liste de raccourcis. Items est de type IVector(JumpListItem).
SystemGroupKind

Obtient ou définit le type actuel du groupe de listes de raccourcis gérées par le système.

Méthodes

IsSupported()

Obtient une valeur qui indique si le système prend en charge les listes de raccourcis.

Notes

Seule la famille d’appareils de bureau prend en charge les listes de raccourcis. Les modifications apportées à une liste de raccourcis avec une autre famille d’appareils ne sont pas conservées.
LoadCurrentAsync()

Récupère de manière asynchrone la liste de raccourcis actuelle et ses éléments.
SaveAsync()

Enregistre de manière asynchrone les modifications apportées à la liste de raccourcis et à ses éléments.

S’applique à

Voir aussi