JumpList.Apply Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Sends the JumpList to the Windows shell in its current state.
public:
void Apply();[System.Security.SecurityCritical]
public void Apply ();public void Apply ();[<System.Security.SecurityCritical>]
member this.Apply : unit -> unitmember this.Apply : unit -> unitPublic Sub Apply ()- Attributes
Exceptions
The JumpList is not completely initialized.
Examples
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();
}
Remarks
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.
