JumpList.JumpItemsRejected JumpList.JumpItemsRejected JumpList.JumpItemsRejected JumpList.JumpItemsRejected Event

Definition

Occurs when jump items are not successfully added to the Jump List by the Windows shell.

public:
 event EventHandler<System::Windows::Shell::JumpItemsRejectedEventArgs ^> ^ JumpItemsRejected;
public event EventHandler<System.Windows.Shell.JumpItemsRejectedEventArgs> JumpItemsRejected;
member this.JumpItemsRejected : EventHandler<System.Windows.Shell.JumpItemsRejectedEventArgs> 
Public Event JumpItemsRejected As EventHandler(Of JumpItemsRejectedEventArgs) 

Examples

The following example shows how to handle the JumpItemsRejected event to display the rejected items in a message box. This example is part of a larger example available in the JumpList class overview.

private void JumpList_JumpItemsRejected(object sender, System.Windows.Shell.JumpItemsRejectedEventArgs e)
{
    StringBuilder sb = new StringBuilder();
    sb.AppendFormat("{0} Jump Items Rejected:\n", e.RejectionReasons.Count);
    for (int i = 0; i < e.RejectionReasons.Count; ++i)
    {
        if (e.RejectedItems[i].GetType() == typeof(JumpPath))
            sb.AppendFormat("Reason: {0}\tItem: {1}\n", e.RejectionReasons[i], ((JumpPath)e.RejectedItems[i]).Path);
        else
            sb.AppendFormat("Reason: {0}\tItem: {1}\n", e.RejectionReasons[i], ((JumpTask)e.RejectedItems[i]).ApplicationPath);
    }

    MessageBox.Show(sb.ToString());
}

Remarks

After the contents of the JumpList are applied to the Windows shell, the JumpItems property is modified to contain only those items that the Windows shell successfully added to its Jump List. You can access the lists of removed items through event handlers for the JumpItemsRejected and JumpItemsRemovedByUser events.

Applies to