AppTaskContent Classe

Definizione

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

Rappresenta il contenuto visualizzato per un'attività dell'app nell'interfaccia utente della shell di Windows. Usare questa classe per creare rappresentazioni visive diverse dello stato e dei risultati dell'attività.

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

AppTaskContent può essere costruito per diverse rappresentazioni supportate:

  • Sequenza di passaggi: mostra lo stato di avanzamento dettagliato dell'esecuzione dell'attività. Usare CreateSequenceOfSteps.
  • Anteprima anteprima: visualizza un'anteprima dell'output dell'attività. Usare CreatePreviewThumbnail.
  • Risultato riepilogo testo: visualizza un riepilogo del risultato dell'attività con una breve descrizione di testo. Usare CreateTextSummaryResult.
  • Risultato degli asset generati: visualizza un riepilogo del risultato dell'attività con asset generati. Usare CreateGeneratedAssetsResult.

Quando un'attività richiede attenzione da parte dell'utente, è possibile aggiungere elementi aggiuntivi usando SetQuestion, AddButton o SetTextInput.

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
MaxButtons

Ottiene il numero massimo di pulsanti che è possibile aggiungere al contenuto dell'attività.

Metodi

Nome Descrizione
AddButton(String, Uri)

Aggiunge un pulsante al contenuto dell'attività su cui l'utente può fare clic per eseguire un'azione.
CreateGeneratedAssetsResult(AppTaskResultAsset[])

Crea il contenuto dell'attività che visualizza una raccolta di asset generati dall'attività.
CreatePreviewThumbnail(Uri, String)

Crea il contenuto dell'attività che visualizza un'anteprima dell'output dell'attività.
CreateSequenceOfSteps(String[], String)

Crea il contenuto dell'attività che visualizza una sequenza di passaggi che mostra lo stato dell'attività.
CreateTextSummaryResult(String)

Crea il contenuto dell'attività che visualizza un riepilogo del testo del risultato dell'attività.
SetQuestion(String)

Imposta una domanda da visualizzare all'utente quando l'attività richiede attenzione.
SetTextInput(String, String)

Imposta un campo di input di testo per consentire all'utente di fornire una risposta di testo in formato libero.

Si applica a