JumpListItem Класс

Определение

Пространство имен:

Windows.UI.StartScreen

Предоставляет функциональные возможности для создания и определения элементов списка переходов для списка переходов приложения.

public ref class JumpListItem sealed

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

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

Public NotInheritable Class JumpListItem

Наследование

Object Platform::Object IInspectable JumpListItem

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v2.0)

Примеры

В следующем примере показано, как создать задачу для JumpList , которая запускает приложение с параметрами командной строки и выполняет нужное действие. Локализация не показана, но возможна для displayName, description и logo с помощью схем URI ms-resource: и ms-appx: .

private Windows.UI.StartScreen.JumpListItem CreateJumpListItemTask()
{
    var taskItem = JumpListItem.CreateWithArguments(
                            "/Argument", "DisplayName");

    // Set the description. (Optional.)
    taskItem.Description = "Compose a new message to " + friendName;

    // Set the logo for this jump list item. Must be ms-appx: or ms-appdata:.
    taskItem.Logo = new Uri("ms-appdata:///local/downloads/taskImage.png");

    // If the GroupName is left blank, then the item goes into the Tasks group by default.

    return taskItem;
}

partial class App
{
    protected override void OnLaunched(LaunchActivatedEventArgs e)
    {
        if (e.Kind == ActivationKind.Launch && e.Arguments == "/Argument")
        {
            // Run code relevant to the task that was selected.
        }
    }
}

Комментарии

JumpListItem создается с помощью методов CreateWithArguments и CreateSeparator . После создания их можно добавить в список переходов приложения с помощью свойства Items списка переходов и метода SaveAsync . Имейте в виду, что в пользовательском интерфейсе пользователь может щелкнуть правой кнопкой мыши элемент списка переходов, который находится в настраиваемой группе, и выбрать "Удалить из этого списка". При выполнении этого действия система помечает элемент как удаленный пользователем и отключает его из пользовательского интерфейса. При следующей загрузке списка переходов приложение должно проверка элементы, чтобы узнать, имеет ли свойство RemovedByUser элемента значение True. Если RemovedByUser имеет значение True, приложение должно обновить свое внутреннее состояние, чтобы синхронизироваться с инициированным пользователем изменением. Приложения обязаны следить за тем, чтобы удаленный элемент не был добавлен обратно в список переходов до тех пор, пока не будут выполнены условия для его добавления, например, когда пользователь снова откроет связанный документ.

Когда приложение сохраняет JumpList с помощью SaveAsync, операционная система упорядочивает элементы следующим образом.

• Все элементы со значением RemovedByUser, равным True, удаляются.
• Элементы с одинаковым свойством GroupName размещаются вместе, сохраняя их относительный порядок.
• Группы упорядочены по исходной позиции первого элемента в группе, за исключением того, что управляемые системой группы всегда находятся вверху, а группа "Задачи" всегда находится внизу, если они присутствуют. Это означает, что когда приложение загружает свой JumpList с помощью метода LoadCurrentAsync , элементы извлекаются в упорядоченном порядке, который может не соответствовать порядку элементов в списке переходов при первоначальном сохранении.

Свойства

Arguments	Возвращает аргументы командной строки для элемента списка переходов.
Description	Возвращает или задает описание задачи элемента списка переходов.
DisplayName	Возвращает или задает отображаемое имя элемента списка переходов. Отображаемое имя также можно указать в качестве параметра с помощью метода CreateWithArguments при создании элемента списка переходов.
GroupName	Возвращает или задает пользовательское имя группы элемента списка переходов. Если имя не указано, элемент будет добавлен в группу Задачи по умолчанию.
Kind	Возвращает JumpListItemKind элемента списка переходов.
Logo	Возвращает или задает логотип элемента списка переходов.
RemovedByUser	Возвращает логическое значение, указывающее, был ли элемент списка переходов удален из списка переходов приложения пользователем.

Методы

CreateSeparator()	Создает элемент списка переходов, который является инертным разделителем для настраиваемой группы в списке переходов приложения.
CreateWithArguments(String, String)	Создает новый элемент списка переходов для списка переходов приложения.

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

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