JumpList.SetJumpList(Application, JumpList) Method

Definition

Namespace:

System.Windows.Shell

Assembly:

PresentationFramework.dll

Sets the JumpList object associated with an application.

public:
 static void SetJumpList(System::Windows::Application ^ application, System::Windows::Shell::JumpList ^ value);

public static void SetJumpList (System.Windows.Application application, System.Windows.Shell.JumpList value);

static member SetJumpList : System.Windows.Application * System.Windows.Shell.JumpList -> unit

Public Shared Sub SetJumpList (application As Application, value As JumpList)

Parameters

application

Application

The application associated with the JumpList.

value

JumpList

The JumpList to associate with the application.

Examples

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

Remarks

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.