The Windows 7 taskbar provides enhanced functionality for launching programs directly from the taskbar button through the use of Jump Lists. The JumpList class provides a managed wrapper for the Jump List functionality in the Windows 7 taskbar and manages the data passed to the Windows shell. The functionality exposed by JumpList is not available in versions of Windows prior to Windows 7.

Jump Lists can contain two types of items, a JumpTask and a JumpPath. A JumpTask is a link to a program and a JumpPath is a link to a file. You can add these items to a CustomCategory or display the standard Recent and Frequent categories that are managed by the Windows shell. You must apply the JumpList to the Windows shell before its contents are available in the taskbar Jump List. You can call the Apply method to send the contents of a JumpList to the Windows shell in its current state.

A JumpList does not automatically have affinity to an Application object. You attach a JumpList to an Application object in code by calling the static SetJumpList method. This also applies the JumpList to the Windows shell. You attach a JumpList to an Application object in XAML by using the attached property syntax. The JumpList class implements the ISupportInitialize interface to support XAML declaration of a JumpList. If the JumpList is declared in XAML and attached to the current Application, it is applied to the Windows shell in the call to the EndInit method when the JumpList is initialized.

You can create multiple JumpList objects. Only one JumpList at a time can be applied to the Windows shell, and only one JumpList at a time can be attached to an Application. However, these do not need to be the same JumpList. You can call the GetJumpList method to get the JumpList currently associated with an Application, which might not be the JumpList currently applied to the Windows shell. Your application cannot query the contents of the Jump List as it exists in the Windows shell.

Note
This class contains a link demand at the class level that applies to all members. A SecurityException is thrown when the immediate caller does not have full-trust permission. For more information about security demands, see Link Demands and Inheritance Demands.

The following example shows how to declare a JumpList in markup. The JumpList contains two JumpTask links and one JumpPath. Applying the JumpPath to the shell will fail if the application is not registered to handle the .txt file 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 read me in Notepad." 
                      ApplicationPath="C:\Windows\notepad.exe"
                      IconResourcePath="C:\Windows\notepad.exe"
                      WorkingDirectory="C:\Users\Public\Documents"
                      Arguments="readme.txt"/>
            <JumpPath Path="C:\Users\Public\Documents\readme.txt" />
        </JumpList>
    </JumpList.JumpList>
</Application>

The following example shows how to create a JumpList in procedural code. The static SetJumpList()()() method is called to associate the JumpList with the current application and apply the JumpList to the Windows shell.

private void SetNewJumpList(object sender, RoutedEventArgs e)
{
    //Configure a JumpTask
    JumpTask jumpTask1 = new JumpTask();
    jumpTask1.ApplicationPath = "C:\\Windows\\write.exe";
    jumpTask1.IconResourcePath = "C:\\Windows\\write.exe";
    jumpTask1.Title = "WordPad";
    jumpTask1.Description = "Open WordPad.";
    jumpTask1.CustomCategory = "Jump List 2";
    // Set the JumpList.
    JumpList jumpList2 = new JumpList();
    jumpList2.JumpItems.Add(jumpTask1);
    JumpList.SetJumpList(App.Current, jumpList2);
}

• UIPermission 

  for full access to modify the Windows shell. Security action: LinkDemand. Associated enumeration: UIPermissionWindow..::.AllWindows

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008, Windows Server 2003

.NET Framework

.NET Framework Client Profile

Reference