AppTaskInfo Clase

Definición

Espacio de nombres:: Windows.UI.Shell.Tasks

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Editar

Representa una tarea de aplicación que se puede mostrar en el Shell de 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

Herencia: Object Platform::Object IInspectable AppTaskInfo

Atributos: ContractVersionAttribute ExperimentalAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Requisitos	Description
Familia de dispositivos	Windows Desktop Extension SDK (se introdujo en la versión 10.0.26100.0)
API contract	Windows.UI.Shell.Tasks.AppTaskContract (se introdujo en la versión v2.0)

Comentarios

Importante

La compatibilidad con tareas de la aplicación comenzará gradualmente a implementarse en Windows 11 a partir de mayo de 2026. Las experiencias habilitadas por Windows.UI.Shell.Tasks las API requieren que la característica de tarea de aplicación correspondiente esté presente en la versión de Windows donde se ejecuta la aplicación. De lo contrario, estas API no tendrán ningún efecto.

Esta clase admite la creación, actualización y eliminación de representaciones de tareas. Las tareas se conservan en sesiones de aplicación y reinicios del sistema.

Para cada tarea, cree una nueva AppTaskInfo instancia y modifíquela para representar el estado de la tarea. Cuando una tarea ya no sea relevante, llame a Remove para quitarla del Shell.

Use IsSupported para comprobar si la característica está disponible antes de intentar crear o enumerar tareas. Use FindAll para enumerar las tareas existentes que se crearon anteriormente.

Los usuarios pueden ocultar las tareas a través de la interfaz de la barra de tareas. Ocultar una tarea no afecta a la tarea que se ejecuta en la aplicación; su representación simplemente se quita de la barra de tareas. La propiedad HiddenByUser indica si el usuario ha ocultado una tarea.

Uso de las APIs para tareas del shell

Las aplicaciones que usan estas API deben empaquetarse. Consulta Información general sobre empaquetado para obtener más información.

También debe agregar com.microsoft.apptaskprovider al manifiesto de la aplicación de la siguiente manera:

<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>

Propiedades

Nombre	Description
DeepLink	Obtiene un URI que se iniciará cuando el usuario haga clic en la representación del shell de la tarea.
EndTime	Obtiene la hora en que esta tarea alcanzó un estado final (por ejemplo `Completed` , o `Error`).
HiddenByUser	Obtiene un valor que indica si el usuario ha ocultado esta tarea a través del Shell de Windows.
IconUri	Obtiene la ruta de acceso a un icono que representa la tarea.
Id	Obtiene el identificador único generado automáticamente para esta tarea.
StartTime	Obtiene la hora en que se creó esta tarea.
State	Obtiene el estado actual de esta tarea.
Subtitle	Obtiene el subtítulo de esta tarea.
Title	Obtiene el título de esta tarea.

Métodos

Nombre	Description
Create(String, String, Uri, Uri, AppTaskContent)	Crea una nueva tarea de aplicación con los parámetros especificados.
FindAll()	Devuelve todas las tareas de aplicación creadas por la aplicación actual.
GetCompletedSteps()	Obtiene la secuencia de pasos que se han completado para esta tarea.
GetExecutingStep()	Obtiene el paso que se está ejecutando actualmente para esta tarea.
IsSupported()	Obtiene un valor que indica si la característica de tarea de aplicación es compatible con el dispositivo actual.
Remove()	Quita esta tarea del Shell de Windows, pero no cambia su estado.
Update(AppTaskState, AppTaskContent)	Actualiza tanto el estado como el contenido de esta tarea.
UpdateDeepLink(Uri)	Actualiza el URI de vínculo profundo para esta tarea.
UpdateState(AppTaskState)	Actualiza el estado de esta tarea sin cambiar su contenido.
UpdateTitles(String, String)	Actualiza el título y el subtítulo de esta tarea.

Se aplica a

Comentarios

¿Le ha resultado útil esta página?