AppTaskInfo クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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
- 継承
- 属性
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 |
このタスクが終了状態 ( |
| 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) |
このタスクのタイトルとサブタイトルを更新します。 |