AppTaskContent Clase

Definición

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

Representa el contenido mostrado para una tarea de aplicación en la interfaz de usuario de Windows Shell. Use esta clase para crear diferentes representaciones visuales del progreso y los resultados de la tarea.

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
Herencia
Object Platform::Object IInspectable AppTaskContent
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.

AppTaskContent se puede construir para diferentes representaciones admitidas:

  • Secuencia de pasos: muestra el progreso paso a paso de la ejecución de tareas. Use CreateSequenceOfSteps.
  • Vista previa de miniatura: muestra una miniatura de vista previa de la salida de la tarea. Use CreatePreviewThumbnail.
  • Resultado de resumen de texto: muestra un resumen del resultado de la tarea con una breve descripción de texto. Use CreateTextSummaryResult.
  • Resultado de los recursos generados: muestra un resumen del resultado de la tarea con los recursos generados. Use CreateGeneratedAssetsResult.

Cuando una tarea necesita atención del usuario, se pueden agregar elementos adicionales mediante SetQuestion, AddButton o SetTextInput.

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
MaxButtons

Obtiene el número máximo de botones que se pueden agregar al contenido de la tarea.

Métodos

Nombre Description
AddButton(String, Uri)

Agrega un botón al contenido de la tarea que el usuario puede hacer clic para realizar una acción.
CreateGeneratedAssetsResult(AppTaskResultAsset[])

Crea contenido de tareas que muestra una colección de recursos generados por la tarea.
CreatePreviewThumbnail(Uri, String)

Crea contenido de tarea que muestra una miniatura de vista previa de la salida de la tarea.
CreateSequenceOfSteps(String[], String)

Crea contenido de tareas que muestra una secuencia de pasos que muestran el progreso de la tarea.
CreateTextSummaryResult(String)

Crea contenido de la tarea que muestra un resumen de texto del resultado de la tarea.
SetQuestion(String)

Establece una pregunta que se mostrará al usuario cuando la tarea necesite atención.
SetTextInput(String, String)

Configura un campo de entrada de texto para que el usuario proporcione una respuesta de texto de forma libre.

Se aplica a