Export (0) Print
Expand All

JumpList::JumpItems Property

Gets the collection of JumpItem objects that are displayed in the Jump List.

Namespace:  System.Windows.Shell
Assembly:  PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: Not mapped to an xmlns.

public:
property List<JumpItem^>^ JumpItems {
	List<JumpItem^>^ get ();
}
<object>
  <List<JumpItem> .../>
</object>

Property Value

Type: System.Collections.Generic::List<JumpItem>
The collection of JumpItem objects displayed in the Jump List. The default is an empty collection.

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.

When a JumpList is created, the JumpItems collection is empty. You can add any JumpTask or JumpPath objects to the collection. The collection will only contain items that have been added by your program. After the JumpList has been passed to the Windows shell by a successful call to either the EndInit or Apply methods, the JumpItems collection will contain only the items that were successfully added to the taskbar Jump List. Items that were not successfully added are removed from the JumpItems collection. You can access the lists of removed items through event handlers for the JumpItemsRejected and JumpItemsRemovedByUser events.

The following example shows how to get the current JumpList and clear the contents of the JumpItems collection. The Apply method is then called to apply the JumpList changes to the Windows shell. This example is part of a larger example available in the JumpList class overview.

private void ClearJumpList(object sender, RoutedEventArgs e)
{
    JumpList jumpList1 = JumpList.GetJumpList(App.Current);
    jumpList1.JumpItems.Clear();
    jumpList1.Apply();
}

.NET Framework

Supported in: 4.6, 4.5, 4

.NET Framework Client Profile

Supported in: 4
Show:
© 2015 Microsoft