AppTaskContent Classe

Definição

Namespace:
Windows.UI.Shell.Tasks
Editar

Representa o conteúdo exibido para uma tarefa de aplicativo na interface do usuário do Windows Shell. Use essa classe para criar diferentes representações visuais de progresso e resultados da tarefa.

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
Herança
Object Platform::Object IInspectable AppTaskContent
Atributos
ContractVersionAttribute ExperimentalAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Requisitos Description
Família de dispositivos
Windows Desktop Extension SDK (introduzida na 10.0.26100.0)
API contract
Windows.UI.Shell.Tasks.AppTaskContract (introduzida na v2.0)

Comentários

Importante

O suporte à tarefa do aplicativo começará a ser implantado gradualmente no Windows 11 a partir de maio de 2026. As experiências habilitadas pelas Windows.UI.Shell.Tasks APIs exigem que o recurso de tarefa de aplicativo correspondente esteja presente na versão do Windows em que o aplicativo é executado. Caso contrário, essas APIs não terão nenhum efeito.

AppTaskContent pode ser construído para diferentes representações com suporte:

  • Sequência de etapas: mostra o progresso passo a passo da execução da tarefa. Use CreateSequenceOfSteps.
  • Miniatura de visualização: exibe uma miniatura de visualização da saída da tarefa. Use CreatePreviewThumbnail.
  • Resultado do resumo do texto: exibe um resumo do resultado da tarefa com uma breve descrição de texto. Use CreateTextSummaryResult.
  • Resultado dos ativos gerados: exibe um resumo do resultado da tarefa com ativos gerados. Use CreateGeneratedAssetsResult.

Quando uma tarefa precisa de atenção do usuário, elementos adicionais podem ser adicionados usando SetQuestion, AddButton ou SetTextInput.

Usando APIs de tarefas do shell

Os aplicativos que usam essas APIs precisam ser empacotados. Confira a visão geral do empacotamento para obter mais informações.

Você também precisa adicionar o com.microsoft.apptaskproviderAppExtension ao manifesto do aplicativo da seguinte maneira:

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

Propriedades

Nome Description
MaxButtons

Obtém o número máximo de botões que podem ser adicionados ao conteúdo da tarefa.

Métodos

Nome Description
AddButton(String, Uri)

Adiciona um botão ao conteúdo da tarefa que o usuário pode clicar para executar uma ação.
CreateGeneratedAssetsResult(AppTaskResultAsset[])

Cria o conteúdo da tarefa que exibe uma coleção de ativos gerados pela tarefa.
CreatePreviewThumbnail(Uri, String)

Cria o conteúdo da tarefa que exibe uma miniatura de visualização da saída da tarefa.
CreateSequenceOfSteps(String[], String)

Cria o conteúdo da tarefa que exibe uma sequência de etapas mostrando o progresso da tarefa.
CreateTextSummaryResult(String)

Cria o conteúdo da tarefa que exibe um resumo de texto do resultado da tarefa.
SetQuestion(String)

Define uma pergunta a ser exibida para o usuário quando a tarefa precisar de atenção.
SetTextInput(String, String)

Configura um campo de entrada de texto para o usuário fornecer uma resposta de texto de forma livre.

Aplica-se a