語言

AppTaskInfo 類別

定義

代表一個可以在 Windows Shell 中顯示的應用程式任務。

public ref class AppTaskInfo 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 AppTaskInfo 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 AppTaskInfo
Public NotInheritable Class AppTaskInfo
繼承
Object Platform::Object IInspectable AppTaskInfo
屬性

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 將不會有任何影響。

此類別支援建立、更新及移除任務表示。 任務會在應用程式會話間持續存在,系統重啟時也是如此。

每個任務建立一個新 AppTaskInfo 實例並修改以代表任務狀態。 當任務不再相關時,呼叫 Remove 將其從 Shell 移除。

在嘗試建立或列舉任務前,請使用 IsSupported 確認此功能是否可用。 使用 FindAll 來列舉先前建立的現有任務。

使用者可以透過工作列介面隱藏任務。 隱藏任務不會影響應用程式中執行的任務;其表示方式只是從工作列中移除。 HiddenByUser 屬性表示該任務是否被使用者隱藏。

使用 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
DeepLink

會獲得一個 URI,當使用者點擊任務的 Shell 表示時會啟動。

EndTime

取得該任務達到結束狀態(例如 Completed 或 Error)的時間。

HiddenByUser

會取得一個值,表示使用者是否透過 Windows Shell 隱藏了這個任務。

IconUri

取得代表任務的圖示路徑。

Id

會自動產生此任務的唯一識別碼。

StartTime

當這個任務被建立時,會得到時間。

State

了解這個任務的現況。

Subtitle

這個任務的副標題。

Title

他得到了這個任務的稱號。

方法

名稱 Description
Create(String, String, Uri, Uri, AppTaskContent)

建立一個新的應用程式任務,並符合指定參數。

FindAll()

回傳目前應用程式所建立的所有應用程式任務。

GetCompletedSteps()

取得此任務已完成的步驟順序。

GetExecutingStep()

取得目前執行此任務的步驟。

IsSupported()

會得到一個值,表示該應用程式的任務功能是否在目前裝置上被支援。

Remove()

會從 Windows Shell 移除這個任務,但不會改變其狀態。

Update(AppTaskState, AppTaskContent)

更新此任務的狀態與內容。

UpdateDeepLink(Uri)

更新此任務的深層連結 URI。

UpdateState(AppTaskState)

更新此任務的狀態,但不改變其內容。

UpdateTitles(String, String)

更新本任務標題及副標題。

適用於