AppTaskContent クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Windows シェル UI でアプリ タスクに表示されるコンテンツを表します。 このクラスを使用して、タスクの進行状況と結果のさまざまな視覚的表現を作成します。
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
- 継承
- 属性
Windows の要件
| 要件 | 説明 |
|---|---|
| デバイス ファミリ |
Windows Desktop Extension SDK (10.0.26100.0 で導入)
|
| API contract |
Windows.UI.Shell.Tasks.AppTaskContract (v2.0 で導入)
|
注釈
Important
アプリ タスクのサポートは、2026 年 5 月から Windows 11 への段階的なロールアウトを開始します。
Windows.UI.Shell.Tasks API によって有効になるエクスペリエンスでは、対応するアプリ タスク機能が、アプリが実行されている Windows のバージョンに存在する必要があります。 それ以外の場合、これらの API は影響を受けなくなります。
AppTaskContent は、サポートされているさまざまな表現に対して構築できます。
- 一連の手順: タスク実行のステップ バイ ステップの進行状況を示します。 CreateSequenceOfSteps を使用します。
- プレビューサムネイル:タスク出力のプレビューサムネイルを表示します。 CreatePreviewThumbnail を使用します。
- テキストの概要の結果: タスクの結果の概要と短いテキストの説明が表示されます。 CreateTextSummaryResult を使用します。
- 生成された資産の結果: 生成された資産を含むタスクの結果の概要が表示されます。 CreateGeneratedAssetsResult を使用します。
タスクでユーザーの注意が必要な場合は、 SetQuestion、 AddButton、または SetTextInput を使用して追加の要素を追加できます。
シェル タスク API の使用
これらの API を使用するアプリはパッケージ化する必要があります。 詳細については、「 パッケージ化の概要 」を参照してください。
次のように、 com.microsoft.apptaskproviderAppExtension をアプリ マニフェストに追加する必要もあります。
<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) |
ユーザーが自由形式のテキスト応答を提供するためのテキスト入力フィールドを設定します。 |