AppTaskContent クラス

定義

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
継承
Object Platform::Object IInspectable 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 を使用します。

タスクでユーザーの注意が必要な場合は、 SetQuestionAddButton、または 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)

ユーザーが自由形式のテキスト応答を提供するためのテキスト入力フィールドを設定します。

適用対象