JumpList Класс

Определение

Предоставляет функциональные возможности для списка переходов приложения. Список переходов — это системное меню, которое отображается, когда пользователь щелкает правой кнопкой мыши программу на панели задач или в меню "Пуск". Он используется для быстрого доступа к недавно или часто используемым документам и предоставления прямых ссылок на функции приложения. Не все семейства устройств поддерживают списки переходов.

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 IInspectable JumpList
Атрибуты

Требования к 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()

Асинхронно сохраняет изменения в списке переходов и его элементах.

Применяется к

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