AppTaskInfo 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
代表一個可以在 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
- 繼承
- 屬性
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 |
取得該任務達到結束狀態(例如 |
| 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) |
更新本任務標題及副標題。 |