JumpList.JumpItems プロパティ

定義

ジャンプ リスト内に表示される JumpItem オブジェクトのコレクションを取得します。Gets the collection of JumpItem objects that are displayed in the Jump List.

public:
 property System::Collections::Generic::List<System::Windows::Shell::JumpItem ^> ^ JumpItems { System::Collections::Generic::List<System::Windows::Shell::JumpItem ^> ^ get(); };
public System.Collections.Generic.List<System.Windows.Shell.JumpItem> JumpItems { get; }
member this.JumpItems : System.Collections.Generic.List<System.Windows.Shell.JumpItem>
Public ReadOnly Property JumpItems As List(Of JumpItem)

プロパティ値

List<JumpItem>

ジャンプ リスト内に表示される JumpItem オブジェクトのコレクション。The collection of JumpItem objects displayed in the Jump List. 既定値は空のコレクションです。The default is an empty collection.

次の例は、現在のを取得し、コレクションの内容をクリアする方法を示して JumpList JumpItems います。The following example shows how to get the current JumpList and clear the contents of the JumpItems collection. Applyその後、メソッドを呼び出して、 JumpList 変更を Windows シェルに適用します。The Apply method is then called to apply the JumpList changes to the Windows shell. この例は、クラスの概要で使用できるより大きな例の一部です JumpListThis 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();
}

注釈

ジャンプリストには、との2種類の項目を含めることができ JumpTask JumpPath ます。Jump Lists can contain two types of items, a JumpTask and a JumpPath. JumpTask プログラムへのリンクであり、は JumpPath ファイルへのリンクです。A JumpTask is a link to a program and a JumpPath is a link to a file.

が作成されると、 JumpList JumpItems コレクションは空になります。When a JumpList is created, the JumpItems collection is empty. JumpTaskまたは JumpPath オブジェクトをコレクションに追加できます。You can add any JumpTask or JumpPath objects to the collection. コレクションには、プログラムによって追加された項目のみが含まれます。The collection will only contain items that have been added by your program. JumpListまたはのいずれかのメソッドの呼び出しが成功すると、が Windows シェルに渡された後 EndInit 、コレクションには、 Apply JumpItems タスクバーのジャンプリストに正常に追加された項目のみが含まれます。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. 正常に追加されなかった項目は、コレクションから削除され JumpItems ます。Items that were not successfully added are removed from the JumpItems collection. イベントおよびイベントのイベントハンドラーを使用して、削除された項目のリストにアクセスでき JumpItemsRejected JumpItemsRemovedByUser ます。You can access the lists of removed items through event handlers for the JumpItemsRejected and JumpItemsRemovedByUser events.

適用対象