AppTaskInfo Classe

Definizione

Spazio dei nomi:
Windows.UI.Shell.Tasks
Modifica

Rappresenta un'attività dell'app che può essere visualizzata nella shell di 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
Ereditarietà
Object Platform::Object IInspectable AppTaskInfo
Attributi
ContractVersionAttribute ExperimentalAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Requisiti Descrizione
Famiglia di dispositivi
Windows Desktop Extension SDK (è stato introdotto in 10.0.26100.0)
API contract
Windows.UI.Shell.Tasks.AppTaskContract (è stato introdotto in v2.0)

Commenti

Importante

Il supporto delle attività per le app inizierà gradualmente a implementare Windows 11 a partire da maggio 2026. Le esperienze abilitate dalle Windows.UI.Shell.Tasks API richiedono che la funzionalità dell'attività dell'app corrispondente sia presente nella versione di Windows in cui viene eseguita l'app. In caso contrario, queste API non avranno alcun effetto.

Questa classe supporta la creazione, l'aggiornamento e la rimozione di rappresentazioni di attività. Le attività vengono mantenute tra le sessioni dell'app e i riavvii del sistema.

Per ogni attività, creare una nuova AppTaskInfo istanza e modificarla per rappresentare lo stato dell'attività. Quando un'attività non è più rilevante, chiama Rimuovi per rimuoverla dalla shell.

Usare IsSupported per verificare se la funzionalità è disponibile prima di tentare di creare o enumerare le attività. Usare FindAll per enumerare le attività esistenti create in precedenza.

Le attività possono essere nascoste dagli utenti tramite l'interfaccia della barra delle applicazioni. Nascondere un'attività non influisce sull'attività in esecuzione nell'app; la relativa rappresentazione viene semplicemente rimossa dalla barra delle applicazioni. La proprietà HiddenByUser indica se un'attività è stata nascosta dall'utente.

Uso delle API delle attività della shell

Le app che usano queste API devono essere in pacchetto. Per altre informazioni , vedi Panoramica dei pacchetti .

Devi anche aggiungere com.microsoft.apptaskprovider al manifesto dell'app come segue:

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

Proprietà

Nome Descrizione
DeepLink

Ottiene un URI che verrà avviato quando l'utente fa clic sulla rappresentazione shell dell'attività.
EndTime

Ottiene l'ora in cui questa attività ha raggiunto uno stato finale, ad esempio Completed o Error.
HiddenByUser

Ottiene un valore che indica se l'utente ha nascosto questa attività tramite la shell di Windows.
IconUri

Ottiene il percorso di un'icona che rappresenta l'attività.
Id

Ottiene l'identificatore univoco generato automaticamente per questa attività.
StartTime

Ottiene l'ora di creazione dell'attività.
State

Ottiene lo stato corrente dell'attività.
Subtitle

Ottiene il sottotitolo di questa attività.
Title

Ottiene il titolo di questa attività.

Metodi

Nome Descrizione
Create(String, String, Uri, Uri, AppTaskContent)

Crea una nuova attività dell'app con i parametri specificati.
FindAll()

Restituisce tutte le attività dell'app create dall'applicazione corrente.
GetCompletedSteps()

Ottiene la sequenza di passaggi completati per questa attività.
GetExecutingStep()

Ottiene il passaggio attualmente in esecuzione per questa attività.
IsSupported()

Ottiene un valore che indica se la funzionalità dell'attività dell'app è supportata nel dispositivo corrente.
Remove()

Rimuove questa attività dalla shell di Windows, ma non ne modifica lo stato.
Update(AppTaskState, AppTaskContent)

Aggiorna sia lo stato che il contenuto di questa attività.
UpdateDeepLink(Uri)

Aggiorna l'URI di collegamento diretto per questa attività.
UpdateState(AppTaskState)

Aggiorna lo stato di questa attività senza modificarne il contenuto.
UpdateTitles(String, String)

Aggiorna il titolo e il sottotitolo di questa attività.

Si applica a