AppTaskInfo 类

定义

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

属性

ContractVersionAttribute ExperimentalAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

注解

此类支持创建、更新和删除任务表示形式。 任务在应用会话和系统重新启动之间持久保存。

对于每个任务，请创建一个新 AppTaskInfo 实例并将其修改为表示任务状态。 当任务不再相关时，请调用 Remove 将其从 Shell 中删除。

使用 IsSupported 检查该功能是否可用，然后再尝试创建或枚举任务。 使用 FindAll 枚举以前创建的现有任务。

用户可以通过任务栏界面隐藏任务。 隐藏任务不会影响在应用中运行的任务;其表示形式只是从任务栏中删除。 HiddenByUser 属性指示任务是否已被用户隐藏。

使用 shell 任务 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>