JumpList JumpList JumpList JumpList Class

定義

Windows 7 タスク バー ボタンにメニューとして表示される項目およびタスクの一覧を表します。Represents a list of items and tasks displayed as a menu on a Windows 7 taskbar button.

public ref class JumpList sealed : System::ComponentModel::ISupportInitialize
[System.Security.SecurityCritical]
[System.Windows.Markup.ContentProperty("JumpItems")]
public sealed class JumpList : System.ComponentModel.ISupportInitialize
type JumpList = class
    interface ISupportInitialize
Public NotInheritable Class JumpList
Implements ISupportInitialize
継承
JumpListJumpListJumpListJumpList
属性
実装

次の例では、ジャンプ リストを持つアプリケーションを示します。The following example shows an application with a Jump List. アプリケーションには、現在のジャンプ リストにタスクを追加、ジャンプ リストの内容を消去および新しいジャンプ リストをアプリケーションに適用するための 3 つのボタンがあります。The application has three buttons that enable you to add a task to the current Jump List, clear the contents of the Jump List, and apply a new Jump List to the application.

次の例は、宣言する方法を示します、JumpListマークアップ。The following example shows how to declare a JumpList in markup. JumpListは 2 つJumpTaskリンクと 1 つJumpPathします。The JumpList contains two JumpTask links and one JumpPath. 適用、JumpPathシェルには、.txt ファイル名拡張子を処理するために、アプリケーションが登録されていない場合は失敗します。Applying the JumpPath to the shell will fail if the application is not registered to handle the .txt file name extension.

<Application x:Class="JumpListSample.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="MainWindow.xaml">
    <JumpList.JumpList>
        <JumpList ShowRecentCategory="True"
                  ShowFrequentCategory="True"
                  JumpItemsRejected="JumpList_JumpItemsRejected"
                  JumpItemsRemovedByUser="JumpList_JumpItemsRemovedByUser">
            <JumpTask Title="Notepad" 
                      Description="Open Notepad." 
                      ApplicationPath="C:\Windows\notepad.exe"
                      IconResourcePath="C:\Windows\notepad.exe"/>
            <JumpTask Title="Read Me" 
                      Description="Open readme.txt in Notepad." 
                      ApplicationPath="C:\Windows\notepad.exe"
                      IconResourcePath="C:\Windows\System32\imageres.dll"
                      IconResourceIndex="14"
                      WorkingDirectory="C:\Users\Public\Documents"
                      Arguments="readme.txt"/>
            <JumpPath Path="C:\Users\Public\Documents\readme.txt" />
        </JumpList>
    </JumpList.JumpList>
</Application>

次の例では、分離コード ページApp.xamlします。The following example shows the code-behind page for App.xaml. このコードは、JumpItemsRejectedJumpItemsRemovedByUserイベント。This code handles the JumpItemsRejected and JumpItemsRemovedByUser events.

using System.Text;
using System.Windows;
using System.Windows.Shell;

namespace JumpListSample
{
    /// <summary>
    /// Interaction logic for App.xaml
    /// </summary>
    public partial class App : Application
    {
        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());
        }

        private void JumpList_JumpItemsRemovedByUser(object sender, System.Windows.Shell.JumpItemsRemovedEventArgs e)
        {
            StringBuilder sb = new StringBuilder();
            sb.AppendFormat("{0} Jump Items Removed by the user:\n", e.RemovedItems.Count);
            for (int i = 0; i < e.RemovedItems.Count; ++i)
            {
                sb.AppendFormat("{0}\n", e.RemovedItems[i]);
            }

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

次の例では、アプリケーションのユーザー インターフェイスを作成するためのマークアップを示します。The following example shows the markup used to create the application user interface.

<Window x:Class="JumpListSample.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Jump List Sample" Height="240" Width="500">
    <Window.Resources>
        <Style TargetType="Button">
            <Setter Property="Width" Value="200" />
            <Setter Property="Margin" Value="5" />
        </Style>
    </Window.Resources>
    <Grid>
        <StackPanel>
            <Button Content="Add Task to JumpList" Click="AddTask" />
            <Button Content="Clear Jump List" Click="ClearJumpList"/>
            <Button Content="Set New Jump List" Click="SetNewJumpList" />
        </StackPanel>
    </Grid>
</Window>

次の例では、分離コード ページMainWindow.xamlします。The following example shows the code-behind page for MainWindow.xaml. このコードは、変更、消去、および作成する方法を示します、JumpList手続き型コードでします。This code demonstrates how to modify, clear, and create a JumpList in procedural code. 新しいジャンプ リストの静的なSetJumpListに関連付けるメソッドが呼び出される、JumpListと現在のアプリケーションを適用し、 JumpList Windows シェルにします。For the new Jump List, the static SetJumpList method is called to associate the JumpList with the current application and apply the JumpList to the Windows shell.

using System;
using System.IO;
using System.Windows;
using System.Windows.Shell;

namespace JumpListSample
{
    /// <summary>
    /// Interaction logic for MainWindow.xaml
    /// </summary>
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }
        private void AddTask(object sender, RoutedEventArgs e)
        {
            // Configure a new JumpTask.
            JumpTask jumpTask1 = new JumpTask();
            // Get the path to Calculator and set the JumpTask properties.
            jumpTask1.ApplicationPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.SystemX86), "calc.exe");
            jumpTask1.IconResourcePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.SystemX86), "calc.exe");
            jumpTask1.Title = "Calculator";
            jumpTask1.Description = "Open Calculator.";
            jumpTask1.CustomCategory = "User Added Tasks";
            // Get the JumpList from the application and update it.
            JumpList jumpList1 = JumpList.GetJumpList(App.Current);
            jumpList1.JumpItems.Add(jumpTask1);
            JumpList.AddToRecentCategory(jumpTask1);
            jumpList1.Apply();
        }
        private void ClearJumpList(object sender, RoutedEventArgs e)
        {
            JumpList jumpList1 = JumpList.GetJumpList(App.Current);
            jumpList1.JumpItems.Clear();
            jumpList1.Apply();
        }
        private void SetNewJumpList(object sender, RoutedEventArgs e)
        {
            //Configure a new JumpTask
            JumpTask jumpTask1 = new JumpTask();
            // Get the path to WordPad and set the JumpTask properties.
            jumpTask1.ApplicationPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.System), "write.exe");
            jumpTask1.IconResourcePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.System), "write.exe");
            jumpTask1.Title = "WordPad";
            jumpTask1.Description = "Open WordPad.";
            jumpTask1.CustomCategory = "Jump List 2";
            // Create and set the new JumpList.
            JumpList jumpList2 = new JumpList();
            jumpList2.JumpItems.Add(jumpTask1);
            JumpList.SetJumpList(App.Current, jumpList2);
        }
    }
}

注釈

Windows 7Windows 7タスク バー ジャンプ リストを使用して、タスク バー ボタンから直接プログラムを起動するための拡張機能を提供します。The Windows 7Windows 7 taskbar provides enhanced functionality for starting programs directly from the taskbar button by using Jump Lists. ジャンプ リストにも使用、 Windows 7Windows 7 [スタート] メニュー。Jump Lists are also used in the Windows 7Windows 7 Start menu. ジャンプ リストは、タスク バー ボタンを右クリックするか、[スタート] メニューのプログラムの横の矢印をクリックしてアクセスします。You access a Jump List by right-clicking a taskbar button or by clicking the arrow next to a program in the Start menu. ジャンプ リストの詳細については、次を参照してください。、タスク バーの Windows ユーザー エクスペリエンス ガイドライン」セクション。For more information about Jump Lists, see the Taskbar section of the Windows User Experience Interaction Guidelines.

JumpListクラスでジャンプ リスト機能のマネージ ラッパーを提供する、Windows 7Windows 7タスク バーに渡されるデータを管理し、WindowsWindowsシェルです。The JumpList class provides a managed wrapper for the Jump List functionality in the Windows 7Windows 7 taskbar and manages the data passed to the WindowsWindows shell. によって公開される機能、JumpListクラスは、のバージョンで使用することはありませんWindowsWindowsよりも前Windows 7Windows 7します。The functionality exposed by the JumpList class is not available in versions of WindowsWindows earlier than Windows 7Windows 7. 使用するアプリケーション、JumpListクラスは、他のバージョンの実行はWindowsWindows、ジャンプ リストは使用できませんが、します。Applications that use the JumpList class will run in other versions of WindowsWindows, but the Jump List will not be available. Windows シェルとジャンプ リストのネイティブ Api の詳細については、次を参照してください。タスク バーの拡張機能します。For more information about the Windows shell and native Jump List APIs, see Taskbar Extensions.

次の図は、ジャンプ リストの Windows Media Player、内の項目を含む、タスク利用頻度カテゴリ。The following illustration shows the Jump List for Windows Media Player, with items in the Tasks and Frequent categories.

Windows Media Player のジャンプ リストWindows Media Player Jump List
Windows メディア プレーヤーのジャンプ リストWindows Media Player Jump List

ジャンプ リストの構成Configuring a Jump List

ジャンプ リストが 2 つの種類の項目を含めることができます、JumpTaskJumpPathします。Jump Lists can contain two types of items, a JumpTask and a JumpPath. AJumpTaskプログラムへのリンクとJumpPathファイルへのリンクです。A JumpTask is a link to a program and a JumpPath is a link to a file. 視覚的に作成してジャンプ リスト内の項目を分離することができます、JumpTaskを持たない、TitleCustomCategory指定します。You can visually separate items in a Jump List by creating a JumpTask that does not have a Title and CustomCategory specified. この空JumpTaskがジャンプ リストに水平方向の線として表示されます。This empty JumpTask will be displayed as a horizontal line in the Jump List.

注意

ファイルの種類が指定されている場合、JumpPathが登録されていないアプリケーション、ファイルは、ジャンプ リストには表示されません。If the type of the file specified in a JumpPath is not registered with your application, the file will not appear in the Jump List. 追加する場合など、 JumpPath .txt ファイルを指す、.txt ファイルを処理するために、アプリケーションを登録する必要があります。For example, if you add a JumpPath that points to a .txt file, your application must be registered to handle .txt files. 詳細については、次を参照してください。ファイルの関連付けの概要します。For more information, see Introduction to File Associations.

内のカテゴリにジャンプ項目が配置されます、JumpListします。Jump items are placed into categories in the JumpList. 既定で、JumpItemに表示される、タスクカテゴリ。By default, a JumpItem is displayed in the Tasks category. または、指定することができます、CustomCategoryJumpItemします。Alternatively, you can specify a CustomCategory for the JumpItem.

指定できるかどうか、標準最近利用頻度カテゴリが表示されます、JumpListを設定して、ShowRecentCategoryShowFrequentCategoryプロパティ。You can specify whether the standard Recent and Frequent categories are displayed in the JumpList by setting the ShowRecentCategory and ShowFrequentCategory properties. これらのカテゴリの内容で管理されて、WindowsWindowsシェルです。The contents of these categories are managed by the WindowsWindows shell. いずれか 1 つでは表示通常これらのカテゴリには、同じデータの多くが含まれている可能性があります、ため、 JumpList、両方ではないです。Because these categories might contain much of the same data, you typically display one or the other in your JumpList, but not both. WindowsWindows コモン ファイル ダイアログ ボックスから開いたまたはファイルの種類の関連付けを使用してアプリケーションを開くために使用された場合、最近使った項目を自動的に管理します。automatically manages recent items if they are opened through a common file dialog box or used to open an application through file type association. ジャンプ リストを項目にアクセスするときは、通知、WindowsWindowsシェル項目を追加する、最近カテゴリを呼び出すことによって、AddToRecentCategoryメソッド。When an item is accessed through the Jump List, you can notify the WindowsWindows shell to add the item to the Recent category by calling the AddToRecentCategory method.

Windows シェルにジャンプ リストを適用します。Applying a Jump List to the Windows Shell

シェルのジャンプ リストに直接アクセスまたはに内容を表示することはできません、JumpListクラス。You cannot access the shell's Jump List directly or read its contents into the JumpList class. 代わりに、JumpListクラスは、使用してに適用し、ジャンプ リストの表現を提供します、WindowsWindowsシェルです。Instead, the JumpList class provides a representation of a Jump List that you can work with, and then apply to the WindowsWindows shell. 通常、作成、JumpListし、1 回のアプリケーションの最初の実行時に設定します。You typically create a JumpList and set it one time when the application is first run. ただし、変更または置換、JumpList実行時にします。However, you can modify or replace the JumpList at run time.

設定した場合、JumpListプロパティを適用する必要がある、JumpListタスク バーのジャンプ リストにその内容が表示されるまでは、Windows シェルにします。When you have set the JumpList properties, you must apply the JumpList to the Windows shell before its contents appear in the taskbar Jump List. これは、自動的にすると、JumpListはまず、XAML またはへの呼び出しでアプリケーションに接続され、SetJumpListメソッド。This is done automatically when the JumpList is first attached to an application, either in XAML or in a call to the SetJumpList method. 内容を変更する場合、 JumpList 、実行時に呼び出す必要がある、 Apply Windows シェルに、現在の内容を適用する方法。If you modify the contents of the JumpList at run time, you must call the Apply method to apply its current contents to the Windows shell.

XAML でのジャンプ リストの設定Setting a Jump List in XAML

AJumpListに自動的にアタッチされていない、Applicationオブジェクト。A JumpList is not automatically attached to an Application object. アタッチする、JumpListApplication添付プロパティの構文を使用して XAML 内のオブジェクト。You attach a JumpList to an Application object in XAML by using the attached property syntax. JumpListクラスが実装する、ISupportInitializeインターフェイスの XAML 宣言をサポートするために、JumpListします。The JumpList class implements the ISupportInitialize interface to support XAML declaration of a JumpList. 場合、JumpListが XAML で宣言され、現在接続されているApplicationが自動的に適用、WindowsWindowsときに、シェル、JumpList初期化されます。If the JumpList is declared in XAML and attached to the current Application, it is automatically applied to the WindowsWindows shell when the JumpList is initialized.

設定とコードでのジャンプ リストの変更Setting and Modifying a Jump List in Code

アタッチする、JumpListApplication静的を呼び出すことによってコード内のオブジェクトSetJumpListメソッド。You attach a JumpList to an Application object in code by calling the static SetJumpList method. これも適用されます、JumpListWindowsWindowsシェルです。This also applies the JumpList to the WindowsWindows shell.

変更する、 JumpList 、実行時に呼び出す、GetJumpListを取得するメソッド、JumpListに現在接続されている、Applicationします。To modify a JumpList at run time, you call the GetJumpList method to get the JumpList that is currently attached to an Application. プロパティを変更した後、 JumpList、呼び出す必要があります、 Apply Windows シェルに変更を適用する方法。After you have modified the properties of the JumpList, you must call the Apply method to apply the changes to the Windows shell.

注意

通常、1 つ作成JumpListに接続される、Applicationに適用されると、WindowsWindowsシェルです。You typically create one JumpList that is attached to the Application and applied to the WindowsWindows shell. ただし、複数作成できますJumpListオブジェクト。However, you can create multiple JumpList objects. 1 つだけJumpList一度にに適用できる、WindowsWindowsシェル、および 1 つだけJumpList一度に関連付けることができる、Applicationします。Only one JumpList at a time can be applied to the WindowsWindows shell, and only one JumpList at a time can be associated with an Application. .NET Framework に同じであるこれらが不要JumpListします。The .NET Framework does not require that these be the same JumpList.

注意

このクラスには、すべてのメンバーに適用されるクラス レベルのリンク確認要求が含まれています。This class contains a link demand at the class level that applies to all members. ASecurityException直前の呼び出し元が完全信頼アクセス許可を持たない場合にスローされます。A SecurityException is thrown when the immediate caller does not have full-trust permission. セキュリティの要求の詳細については、次を参照してください。リンク確認要求継承確認要求します。For more information about security demands, see Link Demands and Inheritance Demands.

コンストラクター

JumpList() JumpList() JumpList() JumpList()

JumpList クラスの新しいインスタンスを初期化します。Initializes a new instance of the JumpList class.

JumpList(IEnumerable<JumpItem>, Boolean, Boolean) JumpList(IEnumerable<JumpItem>, Boolean, Boolean) JumpList(IEnumerable<JumpItem>, Boolean, Boolean) JumpList(IEnumerable<JumpItem>, Boolean, Boolean)

指定したパラメーターを使用して、JumpList クラスの新しいインスタンスを初期化します。Initializes a new instance of the JumpList class with the specified parameters.

プロパティ

JumpItems JumpItems JumpItems JumpItems

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

ShowFrequentCategory ShowFrequentCategory ShowFrequentCategory ShowFrequentCategory

取得または頻繁に使用される項目がジャンプ リストに表示されるかどうかを示す値を設定します。Gets or sets a value that indicates whether frequently used items are displayed in the Jump List.

ShowRecentCategory ShowRecentCategory ShowRecentCategory ShowRecentCategory

取得または最近使用された項目がジャンプ リストに表示されるかどうかを示す値を設定します。Gets or sets a value that indicates whether recently used items are displayed in the Jump List.

メソッド

AddToRecentCategory(JumpPath) AddToRecentCategory(JumpPath) AddToRecentCategory(JumpPath) AddToRecentCategory(JumpPath)

指定したジャンプ パスを、ジャンプ リストの [最近使ったもの] カテゴリに追加します。Adds the specified jump path to the Recent category of the Jump List.

AddToRecentCategory(JumpTask) AddToRecentCategory(JumpTask) AddToRecentCategory(JumpTask) AddToRecentCategory(JumpTask)

指定したジャンプ タスクを、ジャンプ リストの [最近使ったもの] カテゴリに追加します。Adds the specified jump task to the Recent category of the Jump List.

AddToRecentCategory(String) AddToRecentCategory(String) AddToRecentCategory(String) AddToRecentCategory(String)

指定した項目のパスを、ジャンプ リストの [最近使ったもの] カテゴリに追加します。Adds the specified item path to the Recent category of the Jump List.

Apply() Apply() Apply() Apply()

送信、 JumpList Windows シェルの現在の状態にします。Sends the JumpList to the Windows shell in its current state.

BeginInit() BeginInit() BeginInit() BeginInit()

開始を通知、JumpList初期化します。Signals the start of the JumpList initialization.

EndInit() EndInit() EndInit() EndInit()

終端を表す、JumpList初期化します。Signals the end of the JumpList initialization.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetJumpList(Application) GetJumpList(Application) GetJumpList(Application) GetJumpList(Application)

返します、JumpListアプリケーションに関連付けられているオブジェクト。Returns the JumpList object associated with an application.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
SetJumpList(Application, JumpList) SetJumpList(Application, JumpList) SetJumpList(Application, JumpList) SetJumpList(Application, JumpList)

セット、JumpListアプリケーションに関連付けられているオブジェクト。Sets the JumpList object associated with an application.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

イベント

JumpItemsRejected JumpItemsRejected JumpItemsRejected JumpItemsRejected

ジャンプ項目は正常に追加されませんジャンプ リストに Windows シェルによってときに発生します。Occurs when jump items are not successfully added to the Jump List by the Windows shell.

JumpItemsRemovedByUser JumpItemsRemovedByUser JumpItemsRemovedByUser JumpItemsRemovedByUser

以前ジャンプ リストに項目をジャンプは、ユーザーが、一覧から削除されたときに発生します。Occurs when jump items previously in the Jump List are removed from the list by the user.

セキュリティ

UIPermission
Windows シェルを変更するフル アクセス。for full access to modify the Windows shell. セキュリティ アクション:LinkDemandします。Security action: LinkDemand. 関連付けられた列挙体。 AllWindowsAssociated enumeration: AllWindows

適用対象