AppTaskInfo Classe

Definição

Namespace:: Windows.UI.Shell.Tasks

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Editar

Representa uma tarefa de aplicativo que pode ser exibida no Shell do 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

Herança: Object Platform::Object IInspectable AppTaskInfo

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.

Essa classe dá suporte à criação, atualização e remoção de representações de tarefa. As tarefas são mantidas entre sessões de aplicativo e reinicializações do sistema.

Para cada tarefa, crie uma nova AppTaskInfo instância e modifique-a para representar o estado da tarefa. Quando uma tarefa não for mais relevante, chame Remover para removê-la do Shell.

Use IsSupported para verificar se o recurso está disponível antes de tentar criar ou enumerar tarefas. Use FindAll para enumerar tarefas existentes que foram criadas anteriormente.

As tarefas podem ser ocultadas pelos usuários por meio da interface da barra de tarefas. Ocultar uma tarefa não afeta a tarefa em execução no aplicativo; sua representação é simplesmente removida da barra de tarefas. A propriedade HiddenByUser indica se uma tarefa foi ocultada pelo usuário.

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
DeepLink	Obtém um URI que será iniciado quando o usuário clicar na representação shell da tarefa.
EndTime	Obtém a hora em que essa tarefa atingiu um estado final (como `Completed` ou `Error`).
HiddenByUser	Obtém um valor que indica se o usuário escondeu essa tarefa por meio do Shell do Windows.
IconUri	Obtém o caminho para um ícone que representa a tarefa.
Id	Obtém o identificador exclusivo gerado automaticamente para essa tarefa.
StartTime	Obtém a hora em que essa tarefa foi criada.
State	Obtém o estado atual dessa tarefa.
Subtitle	Obtém o subtítulo desta tarefa.
Title	Obtém o título desta tarefa.

Métodos

Nome	Description
Create(String, String, Uri, Uri, AppTaskContent)	Cria uma nova tarefa de aplicativo com os parâmetros especificados.
FindAll()	Retorna todas as tarefas de aplicativo que foram criadas pelo aplicativo atual.
GetCompletedSteps()	Obtém a sequência de etapas que foram concluídas para esta tarefa.
GetExecutingStep()	Obtém a etapa que está sendo executada para essa tarefa no momento.
IsSupported()	Obtém um valor que indica se o recurso de tarefa do aplicativo tem suporte no dispositivo atual.
Remove()	Remove essa tarefa do Windows Shell, mas não altera seu estado.
Update(AppTaskState, AppTaskContent)	Atualiza o estado e o conteúdo dessa tarefa.
UpdateDeepLink(Uri)	Atualiza o URI de link profundo para esta tarefa.
UpdateState(AppTaskState)	Atualiza o estado dessa tarefa sem alterar seu conteúdo.
UpdateTitles(String, String)	Atualiza o título e o subtítulo desta tarefa.

Aplica-se a

Comentários

Esta página foi útil?