JumpList.SetJumpList Method (Application, JumpList)

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Sets the JumpList object associated with an application.

Namespace:   System.Windows.Shell
Assembly:  PresentationFramework (in PresentationFramework.dll)

[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.AllWindows)]
public static void SetJumpList(
	Application application,
	JumpList value


Type: System.Windows.Application

The application associated with the JumpList.

Type: System.Windows.Shell.JumpList

The JumpList to associate with the application.

You can create multiple JumpList objects. However, only one JumpList at a time can be associated with an Application. Call the SetJumpList method to set the JumpList currently associated with an Application.

The following example shows how to create a JumpList in code. The static SetJumpList method is called to associate the JumpList with the current application. The JumpList is automatically applied to the Windows shell when it is set. This example is part of a larger example available in the JumpList class overview.

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();
    JumpList.SetJumpList(App.Current, jumpList2);

.NET Framework
Available since 4.0
Return to top