Export (0) Print
Expand All

JumpList.Apply Method

Sends the JumpList to the Windows shell in its current state.

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

'Declaration
Public Sub Apply

ExceptionCondition
InvalidOperationException

The JumpList is not completely initialized.

The Apply method sends the content of the JumpList to the Windows shell in its current state. After this call is complete, the JumpItems property is modified to contain only those items that the Windows shell successfully added to its taskbar Jump List. 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

  • SecurityCriticalAttribute 

    requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

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:
© 2014 Microsoft