JumpList 类

定义

命名空间:

Windows.UI.StartScreen

为应用的跳转列表提供功能。 跳转列表是系统提供的菜单，当用户在任务栏中或“开始”菜单上右键单击某个程序时，会出现该菜单。 它用于提供对最近或常用文档的快速访问，并提供指向应用功能的直接链接。 并非所有设备系列都支持跳转列表。

public ref class JumpList sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class JumpList final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class JumpList

Public NotInheritable Class JumpList

继承

Object Platform::Object IInspectable JumpList

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10586.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v2.0 中引入)

示例

以下示例演示如何删除应用的跳转列表，包括以前可能添加的任何自定义项。

private async void DisableSystemJumpListAsync()
{
    // Get the app's jump list.
    var jumpList = await Windows.UI.StartScreen.JumpList.LoadCurrentAsync();

    // Disable the system-managed jump list group.
    jumpList.SystemGroupKind = Windows.UI.StartScreen.JumpListSystemGroupKind.None;

    // Remove any previously added custom jump list items.
    jumpList.Items.Clear();

    // Save the changes to the app's jump list.
    await jumpList.SaveAsync();
}

以下示例演示如何设置应用的跳转列表所使用的系统托管组的类型，而不会影响任何现有的自定义跳转列表项。

private async void SetSystemGroupAsync()
{
    // Get the app's jump list.
    var jumpList = await Windows.UI.StartScreen.JumpList.LoadCurrentAsync();

    // Set the system to autogenerate a Frequent group for the app jump list.
    // Alternatively, this property could be set to JumpListSystemGroupKind.Recent to autogenerate a Recent group.
    jumpList.SystemGroupKind = Windows.UI.StartScreen.JumpListSystemGroupKind.Frequent;

    // No changes were made to the jump list Items property, so any custom tasks and groups remain intact.
    await jumpList.SaveAsync();
}

注解

应用的 JumpList 是使用 LoadCurrentAsync 方法检索的。 如果应用程序不自定义其跳转列表，系统将提供默认跳转列表。 目前，默认跳转列表显示最近使用的项。 确保你的应用已注册成为你想要显示在最近项目列表中的特定文件类型的默认文件处理程序。 有关详细信息，请参阅 处理文件激活。

属性

Items	获取跳转列表的 JumpListItem 的列表。 Items 的类型为 IVector (JumpListItem) 。
SystemGroupKind	获取或设置系统管理的跳转列表组的当前类型。

方法

IsSupported()	获取一个值，该值指示系统是否支持跳转列表。 注意 只有桌面设备系列支持跳转列表，对具有不同设备系列的跳转列表所做的更改将不会保留。
LoadCurrentAsync()	异步检索当前跳转列表及其项。
SaveAsync()	异步保存对跳转列表及其项的更改。

另请参阅

• 跳转列表自定义示例