語言

AppTaskContent 類別

定義

命名空間:
Windows.UI.Shell.Tasks
編輯

代表 Windows Shell 介面中應用程式任務所顯示的內容。 利用這堂課創造不同的任務進度與成果視覺呈現。

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 需求

規格需求 Description
裝置系列
Windows Desktop Extension SDK (已於 10.0.26100.0 引進)
API contract
Windows.UI.Shell.Tasks.AppTaskContract (已於 v2.0 引進)

備註

這很重要

應用程式任務支援將從 2026 年 5 月開始逐步推送至 Windows 11。 API Windows.UI.Shell.Tasks 所啟用的體驗要求對應的應用程式任務功能必須存在於該應用程式執行的 Windows 版本中。 否則，這些 API 將不會有任何影響。

AppTaskContent 可以構造出不同的支持表示：

當任務需要使用者注意時，可以使用 SetQuestion、 AddButton 或 SetTextInput 加入額外元素。

使用 Shell 任務 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>

屬性

名稱 Description
MaxButtons

獲得任務內容中最多可新增的按鈕數量。

方法

名稱 Description
AddButton(String, Uri)

在任務內容中新增一個按鈕，使用者可以點擊來執行動作。
CreateGeneratedAssetsResult(AppTaskResultAsset[])

建立任務內容，展示由任務產生的一系列資產。
CreatePreviewThumbnail(Uri, String)

建立任務內容，顯示任務輸出的預覽縮圖。
CreateSequenceOfSteps(String[], String)

建立任務內容，顯示一系列步驟，顯示任務進度。
CreateTextSummaryResult(String)

建立任務內容，顯示任務結果的文字摘要。
SetQuestion(String)

設定一個問題，當任務需要注意時顯示給使用者。
SetTextInput(String, String)

建立文字輸入欄位，讓使用者能提供自由形式的文字回應。

適用於