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 для списка переходов. Элемент имеет тип IVector(JumpListItem).
SystemGroupKind	Возвращает или задает текущий тип группы списка переходов, управляемой системой.

Методы

IsSupported()	Возвращает значение, указывающее, поддерживает ли система списки переходов. Примечание Только семейство настольных устройств поддерживает списки переходов, изменения, внесенные в список переходов с другим семейством устройств, не будут сохраняться.
LoadCurrentAsync()	Асинхронно извлекает текущий список переходов и его элементы.
SaveAsync()	Асинхронно сохраняет изменения в списке переходов и его элементах.

См. также раздел

• Пример настройки списка переходов