JumpList JumpList JumpList JumpList Class

Définition

Représente une liste d’éléments et de tâches affichée sous forme de menu sur un bouton de la barre des tâches Windows 7.Represents a list of items and tasks displayed as a menu on a Windows 7 taskbar button.

public ref class JumpList sealed : System::ComponentModel::ISupportInitialize
[System.Security.SecurityCritical]
[System.Windows.Markup.ContentProperty("JumpItems")]
public sealed class JumpList : System.ComponentModel.ISupportInitialize
type JumpList = class
    interface ISupportInitialize
Public NotInheritable Class JumpList
Implements ISupportInitialize
Héritage
JumpListJumpListJumpListJumpList
Attributs
Implémente

Exemples

L’exemple suivant montre une application avec une liste de raccourcis.The following example shows an application with a Jump List. L’application comporte 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.The application has three buttons that enable you to add a task to the current Jump List, clear the contents of the Jump List, and apply a new Jump List to the application.

L’exemple suivant montre comment déclarer un JumpList dans le balisage.The following example shows how to declare a JumpList in markup. Contient deux JumpTask liens et un JumpPath. JumpListThe JumpList contains two JumpTask links and one JumpPath. L’application JumpPath de à l’interpréteur de commandes échoue si l’application n’est pas inscrite pour gérer l’extension de nom de fichier. txt.Applying the JumpPath to the shell will fail if the application is not registered to handle the .txt file name extension.

<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 illustre la page code-behind de App.xaml.The following example shows the code-behind page for App.xaml. Ce code gère les JumpItemsRejected événements JumpItemsRemovedByUser et.This code handles the JumpItemsRejected and JumpItemsRemovedByUser events.

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.The following example shows the markup used to create the application user interface.

<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 illustre la page code-behind de MainWindow.xaml.The following example shows the code-behind page for MainWindow.xaml. Ce code montre comment modifier, effacer et créer un JumpList dans le code procédural.This code demonstrates how to modify, clear, and create a JumpList in procedural code. Pour la nouvelle liste de raccourcis, la SetJumpList méthode statique est appelée pour associer JumpList le à l’application JumpList actuelle et appliquer à l’interpréteur de commandes Windows.For the new Jump List, the static SetJumpList method is called to associate the JumpList with the current application and apply the JumpList to the Windows shell.

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 Windows 7Windows 7 barre des tâches fournit des fonctionnalités améliorées pour démarrer des programmes directement à partir du bouton de la barre des tâches à l’aide de listes de raccourcis.The Windows 7Windows 7 taskbar provides enhanced functionality for starting programs directly from the taskbar button by using Jump Lists. Les listes de raccourcis sont également utilisées Windows 7Windows 7 dans le menu Démarrer.Jump Lists are also used in the Windows 7Windows 7 Start menu. Pour accéder à une liste de raccourcis, cliquez avec le bouton droit sur un bouton de la barre des tâches ou cliquez sur la flèche en regard d’un programme dans le menu Démarrer.You access a Jump List by right-clicking a taskbar button or by clicking the arrow next to a program in the Start menu. Pour plus d’informations sur les listes de raccourcis, consultez la section barre des tâches des instructions relatives à l’interaction avec l’expérience utilisateur Windows.For more information about Jump Lists, see the Taskbar section of the Windows User Experience Interaction Guidelines.

La JumpList classe fournit un wrapper managé pour la fonctionnalité de liste de raccourcis Windows 7Windows 7 dans la barre des tâches et gère les WindowsWindows données passées à l’interpréteur de commandes.The JumpList class provides a managed wrapper for the Jump List functionality in the Windows 7Windows 7 taskbar and manages the data passed to the WindowsWindows shell. La fonctionnalité exposée par JumpList la classe n’est pas disponible dans WindowsWindows les versions Windows 7Windows 7de antérieures à.The functionality exposed by the JumpList class is not available in versions of WindowsWindows earlier than Windows 7Windows 7. Les applications qui utilisent JumpList la classe s’exécutent dans d' WindowsWindowsautres versions de, mais la liste de raccourcis n’est pas disponible.Applications that use the JumpList class will run in other versions of WindowsWindows, but the Jump List will not be available. Pour plus d’informations sur le shell Windows et les API de liste de raccourcis natives, consultez extensions de la barre des tâches.For more information about the Windows shell and native Jump List APIs, see Taskbar Extensions.

L’illustration suivante montre la liste de raccourcis pour Windows Media Player, avec les éléments des catégories tâches et fréquentes .The following illustration shows the Jump List for Windows Media Player, with items in the Tasks and Frequent categories.

Liste de raccourcis du lecteur Windows MediaWindows Media Player Jump List
Liste de raccourcis Windows Media PlayerWindows Media Player Jump List

Configuration d’une liste de raccourcisConfiguring a Jump List

Les listes de raccourcis peuvent contenir deux types d’éléments JumpTask : un JumpPathet un.Jump Lists can contain two types of items, a JumpTask and a JumpPath. Un JumpTask est un lien vers un programme et un JumpPath est un lien vers un fichier.A JumpTask is a link to a program and a JumpPath is a link to a file. Vous pouvez séparer visuellement des éléments dans une liste de raccourcis en JumpTask créant un qui n’a Title pas CustomCategory de et spécifiés.You can visually separate items in a Jump List by creating a JumpTask that does not have a Title and CustomCategory specified. Ce vide JumpTask s’affichera sous la forme d’une ligne horizontale dans la liste de raccourcis.This empty JumpTask will be displayed as a horizontal line in the Jump List.

Notes

Si le type du fichier spécifié dans un JumpPath n’est pas inscrit auprès de votre application, le fichier n’apparaîtra pas dans la liste de raccourcis.If the type of the file specified in a JumpPath is not registered with your application, the file will not appear in the Jump List. Par exemple, si vous ajoutez un JumpPath point qui pointe vers un fichier. txt, votre application doit être inscrite pour gérer les fichiers. txt.For example, if you add a JumpPath that points to a .txt file, your application must be registered to handle .txt files. Pour plus d’informations, consultez Présentation des associations de fichiers.For more information, see Introduction to File Associations.

Les éléments de saut sont placés dans des JumpListcatégories dans le.Jump items are placed into categories in the JumpList. Par défaut, un JumpItem est affiché dans la catégorie tâches .By default, a JumpItem is displayed in the Tasks category. Vous pouvez également spécifier un CustomCategory pour le. JumpItemAlternatively, you can specify a CustomCategory for the JumpItem.

Vous pouvez spécifier si les catégories standard récentes et fréquentes sont affichées dans JumpList le en définissant ShowFrequentCategory les ShowRecentCategory propriétés et.You can specify whether the standard Recent and Frequent categories are displayed in the JumpList by setting the ShowRecentCategory and ShowFrequentCategory properties. Le contenu de ces catégories est géré par l' WindowsWindows interpréteur de commandes.The contents of these categories are managed by the WindowsWindows shell. Étant donné que ces catégories peuvent contenir une grande partie des mêmes données, vous affichez généralement l’une JumpListou l’autre dans votre, mais pas les deux.Because these categories might contain much of the same data, you typically display one or the other in your JumpList, but not both. WindowsWindowsgère automatiquement les éléments récents s’ils sont ouverts via une boîte de dialogue de fichier commune ou s’ils sont utilisés pour ouvrir une application via l’Association de types de fichiers.automatically manages recent items if they are opened through a common file dialog box or used to open an application through file type association. Quand un élément est accessible via la liste de raccourcis, vous pouvez notifier l' WindowsWindows interpréteur de commandes d’ajouter l’élément à la catégorie récente en appelant la AddToRecentCategory méthode.When an item is accessed through the Jump List, you can notify the WindowsWindows shell to add the item to the Recent category by calling the AddToRecentCategory method.

Application d’une liste de raccourcis à l’interpréteur de commandes WindowsApplying a Jump List to the Windows Shell

Vous ne pouvez pas accéder directement à la liste de raccourcis de l’interpréteur JumpList de commandes ou lire son contenu dans la classe.You cannot access the shell's Jump List directly or read its contents into the JumpList class. Au lieu de JumpList cela, la classe fournit une représentation d’une liste de raccourcis que vous pouvez utiliser, puis s' WindowsWindows applique à l’interpréteur de commandes.Instead, the JumpList class provides a representation of a Jump List that you can work with, and then apply to the WindowsWindows shell. En général, vous JumpList créez un et le définissez une fois lorsque l’application est exécutée pour la première fois.You typically create a JumpList and set it one time when the application is first run. Toutefois, vous pouvez modifier ou remplacer au JumpList moment de l’exécution.However, you can modify or replace the JumpList at run time.

Lorsque vous avez défini les JumpList propriétés, vous devez JumpList appliquer à l’interpréteur de commandes Windows avant que son contenu n’apparaisse dans la liste de raccourcis de la barre des tâches.When you have set the JumpList properties, you must apply the JumpList to the Windows shell before its contents appear in the taskbar Jump List. Cela se fait automatiquement lorsque le JumpList est d’abord attaché à une application, en XAML ou dans un appel à la SetJumpList méthode.This is done automatically when the JumpList is first attached to an application, either in XAML or in a call to the SetJumpList method. Si vous modifiez le contenu de au JumpList moment de l’exécution, vous devez appeler Apply la méthode pour appliquer son contenu actuel au shell Windows.If you modify the contents of the JumpList at run time, you must call the Apply method to apply its current contents to the Windows shell.

Définition d’une liste de raccourcis en XAMLSetting a Jump List in XAML

Un JumpList n’est pas automatiquement attaché à Application un objet.A JumpList is not automatically attached to an Application object. Vous attachez JumpList un à Application un objet en XAML à l’aide de la syntaxe de propriété jointe.You attach a JumpList to an Application object in XAML by using the attached property syntax. La JumpList classe implémente l' ISupportInitialize interface pour prendre en charge la Déclaration JumpListXAML d’un.The JumpList class implements the ISupportInitialize interface to support XAML declaration of a JumpList. Si le JumpList est déclaré en XAML et attaché au actuel Application, il est appliqué automatiquement à l' WindowsWindows interpréteur de commandes JumpList lorsque le est initialisé.If the JumpList is declared in XAML and attached to the current Application, it is automatically applied to the WindowsWindows shell when the JumpList is initialized.

Définition et modification d’une liste de raccourcis dans le codeSetting and Modifying a Jump List in Code

Vous attachez JumpList un à Application un objet dans le code en appelant SetJumpList la méthode statique.You attach a JumpList to an Application object in code by calling the static SetJumpList method. Cela applique JumpList également à l' WindowsWindows interpréteur de commandes.This also applies the JumpList to the WindowsWindows shell.

Pour modifier un JumpList au moment de l’exécution, vous GetJumpList appelez la méthode pour JumpList obtenir le qui est actuellement attaché Applicationà un.To modify a JumpList at run time, you call the GetJumpList method to get the JumpList that is currently attached to an Application. Après avoir modifié les propriétés du JumpList, vous devez appeler la Apply méthode pour appliquer les modifications au shell Windows.After you have modified the properties of the JumpList, you must call the Apply method to apply the changes to the Windows shell.

Notes

En général, vous JumpList en créez un qui est Application associé au et appliqué WindowsWindows à l’interpréteur de commandes.You typically create one JumpList that is attached to the Application and applied to the WindowsWindows shell. Toutefois, vous pouvez créer plusieurs JumpList objets.However, you can create multiple JumpList objects. Une JumpList seule à la fois peut être appliquée à l' WindowsWindows interpréteur de commandes, JumpList et une seule à la fois peut être Applicationassociée à un.Only one JumpList at a time can be applied to the WindowsWindows shell, and only one JumpList at a time can be associated with an Application. La .NET Framework ne requiert pas qu’elles soient identiques JumpList.The .NET Framework does not require that these be the same JumpList.

Notes

Cette classe contient une demande de liaison au niveau de la classe qui s’applique à tous les membres.This class contains a link demand at the class level that applies to all members. Une SecurityException exception est levée lorsque l’appelant immédiat n’a pas d’autorisation de confiance totale.A SecurityException is thrown when the immediate caller does not have full-trust permission. Pour plus d’informations sur les demandes de sécurité, consultez demandes de liaison et demandes d’héritage.For more information about security demands, see Link Demands and Inheritance Demands.

Constructeurs

JumpList() JumpList() JumpList() JumpList()

Initialise une nouvelle instance de la classe JumpList.Initializes a new instance of the JumpList class.

JumpList(IEnumerable<JumpItem>, Boolean, Boolean) JumpList(IEnumerable<JumpItem>, Boolean, Boolean) JumpList(IEnumerable<JumpItem>, Boolean, Boolean) JumpList(IEnumerable<JumpItem>, Boolean, Boolean)

Initialise une nouvelle instance de la classe JumpList avec les paramètres spécifiés.Initializes a new instance of the JumpList class with the specified parameters.

Propriétés

JumpItems JumpItems JumpItems JumpItems

Obtient la collection d'objets JumpItem affichés dans la Liste de raccourcis.Gets the collection of JumpItem objects that are displayed in the Jump List.

ShowFrequentCategory ShowFrequentCategory ShowFrequentCategory ShowFrequentCategory

Obtient ou définit une valeur qui indique si les éléments fréquemment utilisés sont affichés dans la Liste de raccourcis.Gets or sets a value that indicates whether frequently used items are displayed in the Jump List.

ShowRecentCategory ShowRecentCategory ShowRecentCategory ShowRecentCategory

Obtient ou définit une valeur qui indique si les éléments récemment utilisés sont affichés dans la Liste de raccourcis.Gets or sets a value that indicates whether recently used items are displayed in the Jump List.

Méthodes

AddToRecentCategory(JumpPath) AddToRecentCategory(JumpPath) AddToRecentCategory(JumpPath) AddToRecentCategory(JumpPath)

Ajoute le chemin du raccourci spécifié à la catégorie Recent de la Liste de raccourcis.Adds the specified jump path to the Recent category of the Jump List.

AddToRecentCategory(JumpTask) AddToRecentCategory(JumpTask) AddToRecentCategory(JumpTask) AddToRecentCategory(JumpTask)

Ajoute la tâche de raccourci spécifiée à la catégorie Recent de la Liste de raccourcis.Adds the specified jump task to the Recent category of the Jump List.

AddToRecentCategory(String) AddToRecentCategory(String) AddToRecentCategory(String) AddToRecentCategory(String)

Ajoute le chemin de l’élément spécifié à la catégorie Recent de la Liste de raccourcis.Adds the specified item path to the Recent category of the Jump List.

Apply() Apply() Apply() Apply()

Envoie JumpList au shell Windows dans son état actuel.Sends the JumpList to the Windows shell in its current state.

BeginInit() BeginInit() BeginInit() BeginInit()

Signale le début de l'initialisation de JumpList.Signals the start of the JumpList initialization.

EndInit() EndInit() EndInit() EndInit()

Signale la fin de l'initialisation de JumpList.Signals the end of the JumpList initialization.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetJumpList(Application) GetJumpList(Application) GetJumpList(Application) GetJumpList(Application)

Retourne l'objet JumpList associé à une application.Returns the JumpList object associated with an application.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
SetJumpList(Application, JumpList) SetJumpList(Application, JumpList) SetJumpList(Application, JumpList) SetJumpList(Application, JumpList)

Définit l'objet JumpList associé à une application.Sets the JumpList object associated with an application.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Événements

JumpItemsRejected JumpItemsRejected JumpItemsRejected JumpItemsRejected

Se produit en cas d'échec de l'ajout d'éléments de saut à la Liste de raccourcis par le shell Windows.Occurs when jump items are not successfully added to the Jump List by the Windows shell.

JumpItemsRemovedByUser JumpItemsRemovedByUser JumpItemsRemovedByUser JumpItemsRemovedByUser

Se produit lorsque des éléments de raccourci figurant précédemment dans la Liste de raccourcis sont supprimés de la liste par l'utilisateur.Occurs when jump items previously in the Jump List are removed from the list by the user.

Sécurité

UIPermission
pour un accès complet afin de modifier le shell Windows.for full access to modify the Windows shell. Action de sécurité LinkDemand:.Security action: LinkDemand. Énumération associée:AllWindowsAssociated enumeration: AllWindows

S’applique à