AppTaskContent Класс

Определение

Пространство имен:
Windows.UI.Shell.Tasks
Изменить

Представляет содержимое, отображаемое для задачи приложения в пользовательском интерфейсе оболочки Windows. Используйте этот класс для создания различных визуальных представлений хода выполнения и результатов задачи.

public ref class AppTaskContent sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.UI.Shell.Tasks.AppTaskContract, 65536)]
/// [Windows.Foundation.Metadata.Experimental]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppTaskContent final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.UI.Shell.Tasks.AppTaskContract), 65536)]
[Windows.Foundation.Metadata.Experimental]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppTaskContent
Public NotInheritable Class AppTaskContent
Наследование
Object Platform::Object IInspectable AppTaskContent
Атрибуты
ContractVersionAttribute ExperimentalAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Требования Описание
Семейство устройств
Windows Desktop Extension SDK (появилось в 10.0.26100.0)
API contract
Windows.UI.Shell.Tasks.AppTaskContract (появилось в v2.0)

Комментарии

Important

Поддержка задач приложений начнет постепенно развертываться в Windows 11 с мая 2026 года. Интерфейсы, включенные Windows.UI.Shell.Tasks API, требуют, чтобы соответствующая функция задачи приложения присутствовала в версии Windows, в которой выполняется приложение. В противном случае эти API не будут иметь никакого эффекта.

AppTaskContent можно создать для различных поддерживаемых представлений:

  • Последовательность шагов. Показывает пошаговый ход выполнения задачи. Используйте CreateSequenceOfSteps.
  • Эскиз предварительного просмотра: отображает эскиз выходных данных задачи предварительного просмотра. Используйте CreatePreviewThumbnail.
  • Результат сводки текста: отображает сводку результата задачи с коротким текстовым описанием. Используйте CreateTextSummaryResult.
  • Результат созданных ресурсов: отображает сводку результата задачи с созданными ресурсами. Используйте CreateGeneratedAssetsResult.

Если задача требует внимания пользователя, можно добавить дополнительные элементы с помощью SetQuestion, AddButton или SetTextInput.

Использование API для задач оболочки

Приложения, использующие эти API, необходимо упаковать. Дополнительные сведения см. в разделе "Упаковка ".

Кроме того, необходимо добавить com.microsoft.apptaskprovider в манифест приложения следующим образом:

<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="rescap uap uap3">
...

<Application>
  ...
  <Extensions>
    <uap3:Extension Category="windows.appExtension">
        <uap3:AppExtension
            Name="com.microsoft.apptaskprovider"
            PublicFolder="Public"
            Id="MyApp.AppTaskProvider"
            DisplayName="AppTaskProvider for MyApp"/>
    </uap3:Extension>
  </Extensions>
  ...
</Application>

...
</Package>

Свойства

Имя Описание
MaxButtons

Возвращает максимальное количество кнопок, которые можно добавить в содержимое задачи.

Методы

Имя Описание
AddButton(String, Uri)

Добавляет кнопку в содержимое задачи, которое пользователь может нажать, чтобы выполнить действие.
CreateGeneratedAssetsResult(AppTaskResultAsset[])

Создает содержимое задачи, отображающее коллекцию ресурсов, созданных задачей.
CreatePreviewThumbnail(Uri, String)

Создает содержимое задачи, отображающее эскиз выходных данных задачи предварительного просмотра.
CreateSequenceOfSteps(String[], String)

Создает содержимое задачи, отображающее последовательность шагов, показывающих ход выполнения задачи.
CreateTextSummaryResult(String)

Создает содержимое задачи, отображающее текстовую сводку результата задачи.
SetQuestion(String)

Задает вопрос, отображаемый пользователю, когда задача нуждается в внимания.
SetTextInput(String, String)

Настраивает поле ввода текста для пользователя, чтобы предоставить ответ на текст свободной формы.

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