AppTaskInfo クラス

定義

Windows シェルに表示できるアプリ タスクを表します。

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 の要件

要件 説明
デバイス ファミリ
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 は影響を受けなくなります。

このクラスは、タスク表現の作成、更新、および削除をサポートします。 タスクは、アプリ セッションとシステム再起動の間で保持されます。

タスクごとに、新しい AppTaskInfo インスタンスを作成し、タスクの状態を表すために変更します。 タスクが関連しなくなったら、 Remove を呼び出してシェルから削除します。

IsSupported を使用して、タスクを作成または列挙する前に機能が使用可能かどうかを確認します。 FindAll を使用して、以前に作成された既存のタスクを列挙します。

タスクは、タスク バー インターフェイスを介してユーザーが非表示にすることができます。 タスクを非表示にしても、アプリで実行されているタスクには影響しません。その表現は単にタスク バーから削除されます。 HiddenByUser プロパティは、タスクがユーザーによって非表示になっているかどうかを示します。

シェル タスク 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>

プロパティ

名前 説明
DeepLink

ユーザーがタスクのシェル表現をクリックしたときに起動される URI を取得します。

EndTime

このタスクが終了状態 ( CompletedErrorなど) に達した時刻を取得します。

HiddenByUser

ユーザーがこのタスクを Windows シェルで非表示にしたかどうかを示す値を取得します。

IconUri

タスクを表すアイコンへのパスを取得します。

Id

このタスクに対して自動的に生成される一意識別子を取得します。

StartTime

このタスクが作成された時刻を取得します。

State

このタスクの現在の状態を取得します。

Subtitle

このタスクのサブタイトルを取得します。

Title

このタスクのタイトルを取得します。

メソッド

名前 説明
Create(String, String, Uri, Uri, AppTaskContent)

指定したパラメーターを使用して新しいアプリ タスクを作成します。

FindAll()

現在のアプリケーションによって作成されたすべてのアプリ タスクを返します。

GetCompletedSteps()

このタスクに対して完了した一連の手順を取得します。

GetExecutingStep()

このタスクで現在実行中のステップを取得します。

IsSupported()

アプリ タスク機能が現在のデバイスでサポートされているかどうかを示す値を取得します。

Remove()

Windows シェルからこのタスクを削除しますが、その状態は変更されません。

Update(AppTaskState, AppTaskContent)

このタスクの状態と内容の両方を更新します。

UpdateDeepLink(Uri)

このタスクのディープ リンク URI を更新します。

UpdateState(AppTaskState)

コンテンツを変更せずに、このタスクの状態を更新します。

UpdateTitles(String, String)

このタスクのタイトルとサブタイトルを更新します。

適用対象