Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
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.

'Declaration
Public ReadOnly Property JumpItems As List(Of JumpItem)
	Get
<object>
  <List<JumpItem> .../>
</object>

Property Value

Type: System.Collections.Generic.List(Of 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

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2015 Microsoft