JumpList Classe

Définition

public ref class JumpList sealed : System::ComponentModel::ISupportInitialize

[System.Windows.Markup.ContentProperty("JumpItems")]
public sealed class JumpList : System.ComponentModel.ISupportInitialize

[System.Windows.Markup.ContentProperty("JumpItems")]
[System.Security.SecurityCritical]
public sealed class JumpList : System.ComponentModel.ISupportInitialize

[<System.Windows.Markup.ContentProperty("JumpItems")>]
type JumpList = class
    interface ISupportInitialize

[<System.Windows.Markup.ContentProperty("JumpItems")>]
[<System.Security.SecurityCritical>]
type JumpList = class
    interface ISupportInitialize

Public NotInheritable Class JumpList
Implements ISupportInitialize

Héritage

Object

JumpList

Attributs

ContentPropertyAttribute SecurityCriticalAttribute

Implémente

ISupportInitialize

Exemples

L’exemple suivant montre une application avec une liste de raccourcis. L’application dispose de trois boutons qui vous permettent d’ajouter une tâche à la liste de raccourcis actuelle, d’effacer le contenu de la liste de raccourcis et d’appliquer une nouvelle liste de raccourcis à l’application.

L’exemple suivant montre comment déclarer un dans le JumpList balisage. contient JumpList deux JumpTask liens et un JumpPath. L’application du JumpPath à l’interpréteur de commandes échoue si l’application n’est pas inscrite pour gérer l’extension de nom de fichier .txt.

<Application x:Class="JumpListSample.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="MainWindow.xaml">
    <JumpList.JumpList>
        <JumpList ShowRecentCategory="True"
                  ShowFrequentCategory="True"
                  JumpItemsRejected="JumpList_JumpItemsRejected"
                  JumpItemsRemovedByUser="JumpList_JumpItemsRemovedByUser">
            <JumpTask Title="Notepad" 
                      Description="Open Notepad." 
                      ApplicationPath="C:\Windows\notepad.exe"
                      IconResourcePath="C:\Windows\notepad.exe"/>
            <JumpTask Title="Read Me" 
                      Description="Open readme.txt in Notepad." 
                      ApplicationPath="C:\Windows\notepad.exe"
                      IconResourcePath="C:\Windows\System32\imageres.dll"
                      IconResourceIndex="14"
                      WorkingDirectory="C:\Users\Public\Documents"
                      Arguments="readme.txt"/>
            <JumpPath Path="C:\Users\Public\Documents\readme.txt" />
        </JumpList>
    </JumpList.JumpList>
</Application>

L’exemple suivant montre la page code-behind pour App.xaml. Ce code gère les JumpItemsRejected événements et JumpItemsRemovedByUser .

using System.Text;
using System.Windows;
using System.Windows.Shell;

namespace JumpListSample
{
    /// <summary>
    /// Interaction logic for App.xaml
    /// </summary>
    public partial class App : Application
    {
        private void JumpList_JumpItemsRejected(object sender, System.Windows.Shell.JumpItemsRejectedEventArgs e)
        {
            StringBuilder sb = new StringBuilder();
            sb.AppendFormat("{0} Jump Items Rejected:\n", e.RejectionReasons.Count);
            for (int i = 0; i < e.RejectionReasons.Count; ++i)
            {
                if (e.RejectedItems[i].GetType() == typeof(JumpPath))
                    sb.AppendFormat("Reason: {0}\tItem: {1}\n", e.RejectionReasons[i], ((JumpPath)e.RejectedItems[i]).Path);
                else
                    sb.AppendFormat("Reason: {0}\tItem: {1}\n", e.RejectionReasons[i], ((JumpTask)e.RejectedItems[i]).ApplicationPath);
            }

            MessageBox.Show(sb.ToString());
        }

        private void JumpList_JumpItemsRemovedByUser(object sender, System.Windows.Shell.JumpItemsRemovedEventArgs e)
        {
            StringBuilder sb = new StringBuilder();
            sb.AppendFormat("{0} Jump Items Removed by the user:\n", e.RemovedItems.Count);
            for (int i = 0; i < e.RemovedItems.Count; ++i)
            {
                sb.AppendFormat("{0}\n", e.RemovedItems[i]);
            }

            MessageBox.Show(sb.ToString());
        }
    }
}

L’exemple suivant montre le balisage utilisé pour créer l’interface utilisateur de l’application.

<Window x:Class="JumpListSample.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Jump List Sample" Height="240" Width="500">
    <Window.Resources>
        <Style TargetType="Button">
            <Setter Property="Width" Value="200" />
            <Setter Property="Margin" Value="5" />
        </Style>
    </Window.Resources>
    <Grid>
        <StackPanel>
            <Button Content="Add Task to JumpList" Click="AddTask" />
            <Button Content="Clear Jump List" Click="ClearJumpList"/>
            <Button Content="Set New Jump List" Click="SetNewJumpList" />
        </StackPanel>
    </Grid>
</Window>

L’exemple suivant montre la page code-behind pour MainWindow.xaml. Ce code montre comment modifier, effacer et créer un dans le JumpList code procédural. Pour la nouvelle liste de raccourcis, la méthode statique SetJumpList est appelée pour associer à l’application JumpList actuelle et appliquer à JumpList l’interpréteur de commandes Windows.

using System;
using System.IO;
using System.Windows;
using System.Windows.Shell;

namespace JumpListSample
{
    /// <summary>
    /// Interaction logic for MainWindow.xaml
    /// </summary>
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }
        private void AddTask(object sender, RoutedEventArgs e)
        {
            // Configure a new JumpTask.
            JumpTask jumpTask1 = new JumpTask();
            // Get the path to Calculator and set the JumpTask properties.
            jumpTask1.ApplicationPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.SystemX86), "calc.exe");
            jumpTask1.IconResourcePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.SystemX86), "calc.exe");
            jumpTask1.Title = "Calculator";
            jumpTask1.Description = "Open Calculator.";
            jumpTask1.CustomCategory = "User Added Tasks";
            // Get the JumpList from the application and update it.
            JumpList jumpList1 = JumpList.GetJumpList(App.Current);
            jumpList1.JumpItems.Add(jumpTask1);
            JumpList.AddToRecentCategory(jumpTask1);
            jumpList1.Apply();
        }
        private void ClearJumpList(object sender, RoutedEventArgs e)
        {
            JumpList jumpList1 = JumpList.GetJumpList(App.Current);
            jumpList1.JumpItems.Clear();
            jumpList1.Apply();
        }
        private void SetNewJumpList(object sender, RoutedEventArgs e)
        {
            //Configure a new JumpTask
            JumpTask jumpTask1 = new JumpTask();
            // Get the path to WordPad and set the JumpTask properties.
            jumpTask1.ApplicationPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.System), "write.exe");
            jumpTask1.IconResourcePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.System), "write.exe");
            jumpTask1.Title = "WordPad";
            jumpTask1.Description = "Open WordPad.";
            jumpTask1.CustomCategory = "Jump List 2";
            // Create and set the new JumpList.
            JumpList jumpList2 = new JumpList();
            jumpList2.JumpItems.Add(jumpTask1);
            JumpList.SetJumpList(App.Current, jumpList2);
        }
    }
}

Remarques

La barre des tâches Windows 7 offre des fonctionnalités améliorées pour démarrer des programmes directement à partir du bouton de barre des tâches à l’aide de listes de raccourcis. Les listes de raccourcis sont également utilisées dans le menu Démarrer de Windows 7. Vous accédez à une liste de raccourcis en cliquant avec le bouton droit sur un bouton de barre des tâches ou en cliquant sur la flèche en regard d’un programme dans le menu Démarrer. Pour plus d’informations sur les listes de raccourcis, consultez la section Barre des tâches des Instructions d’interaction de l’expérience utilisateur Windows.

La JumpList classe fournit un wrapper managé pour la fonctionnalité liste de raccourcis dans la barre des tâches Windows 7 et gère les données passées à l’interpréteur de commandes Windows. Les fonctionnalités exposées par la JumpList classe ne sont pas disponibles dans les versions de Windows antérieures à Windows 7. Les applications qui utilisent la JumpList classe s’exécutent dans d’autres versions de Windows, mais la liste de raccourcis ne sera pas disponible. Pour plus d’informations sur l’interpréteur de commandes Windows et les API de liste de raccourcis natives, consultez Extensions de la barre des tâches.

L’illustration suivante montre la liste de raccourcis pour le Lecteur Windows Media, avec des éléments dans les catégories Tâches et Fréquences .

Liste de
Liste de raccourcis Windows Media Player

Configuration d’une liste de raccourcis

Les listes de raccourcis peuvent contenir deux types d’éléments , un JumpTask et un JumpPath. Un JumpTask est un lien vers un programme et un JumpPath est un lien vers un fichier. Vous pouvez séparer visuellement les éléments d’une liste de raccourcis en créant un JumpTask qui n’a pas de Title et CustomCategory spécifié. Ce vide JumpTask s’affiche sous la forme d’une ligne horizontale dans la liste de raccourcis.

Les éléments de saut sont placés dans des catégories dans le JumpList. Par défaut, un JumpItem est affiché dans la catégorie Tâches . Vous pouvez également spécifier un CustomCategory pour .JumpItem

Vous pouvez spécifier si les catégories Standard Récent et Fréquent sont affichées dans le JumpList en définissant les ShowRecentCategory propriétés et ShowFrequentCategory . Le contenu de ces catégories est géré par l’interpréteur de commandes Windows. Étant donné que ces catégories peuvent contenir une grande partie des mêmes données, vous affichez généralement l’une ou l’autre dans votre JumpList, mais pas les deux. Windows gère automatiquement les éléments récents s’ils sont ouverts via une boîte de dialogue de fichier commune ou utilisés pour ouvrir une application par le biais d’une association de type de fichier. Lorsqu’un élément est accessible via la liste de raccourcis, vous pouvez informer l’interpréteur de commandes Windows d’ajouter l’élément à la catégorie Récent en appelant la AddToRecentCategory méthode .

Application d’une liste de raccourcis à l’interpréteur de commandes Windows

Vous ne pouvez pas accéder directement à la liste de raccourcis de l’interpréteur de commandes ou lire son contenu dans la JumpList classe . Au lieu de cela, la JumpList classe fournit une représentation d’une liste de raccourcis que vous pouvez utiliser, puis appliquer à l’interpréteur de commandes Windows. En règle générale, vous créez un JumpList et vous le définissez une fois lors de la première exécution de l’application. Toutefois, vous pouvez modifier ou remplacer au moment de l’exécution JumpList .

Une fois que vous avez défini les JumpList propriétés, vous devez appliquer à JumpList l’interpréteur de commandes Windows avant que son contenu apparaisse dans la liste de raccourcis de la barre des tâches. Cette opération est effectuée automatiquement lorsque le est attaché pour la JumpList première fois à une application, soit en XAML, soit dans un appel à la SetJumpList méthode . Si vous modifiez le contenu du au moment de l’exécution JumpList , vous devez appeler la Apply méthode pour appliquer son contenu actuel à l’interpréteur de commandes Windows.

Définition d’une liste de raccourcis en XAML

Un JumpList n’est pas automatiquement attaché à un Application objet . Vous attachez un JumpList à un Application objet en XAML à l’aide de la syntaxe de propriété jointe. La JumpList classe implémente l’interface ISupportInitialize pour prendre en charge la déclaration XAML d’un JumpList. Si est JumpList déclaré en XAML et attaché au actuel Application, il est automatiquement appliqué à l’interpréteur de commandes Windows lorsque est JumpList initialisé.

Définition et modification d’une liste de raccourcis dans le code

Vous attachez un JumpList à un Application objet dans le code en appelant la méthode statique SetJumpList . Cela s’applique également à JumpList l’interpréteur de commandes Windows.

Pour modifier un JumpList au moment de l’exécution, vous appelez la GetJumpList méthode pour obtenir le JumpList qui est actuellement attaché à un Application. Après avoir modifié les propriétés de , JumpListvous devez appeler la Apply méthode pour appliquer les modifications à l’interpréteur de commandes Windows.

Constructeurs

Propriétés

Méthodes

Événements

S’applique à