AppTaskContent Klasse

Definition

Stellt den Inhalt dar, der für eine App-Aufgabe in der Windows-Shell-Benutzeroberfläche angezeigt wird. Verwenden Sie diese Klasse, um unterschiedliche visuelle Darstellungen des Vorgangsfortschritts und der Ergebnisse zu erstellen.

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
Vererbung
Object Platform::Object IInspectable AppTaskContent
Attribute

Windows-Anforderungen

Anforderungen Beschreibung
Gerätefamilie
Windows Desktop Extension SDK (eingeführt in 10.0.26100.0)
API contract
Windows.UI.Shell.Tasks.AppTaskContract (eingeführt in v2.0)

Hinweise

Von Bedeutung

Die App-Aufgabenunterstützung wird ab Mai 2026 schrittweise für Windows 11 eingeführt. Die von Windows.UI.Shell.Tasks APIs aktivierten Erfahrungen erfordern, dass das entsprechende App-Aufgabenfeature in der Windows-Version vorhanden ist, in der die App ausgeführt wird. Andernfalls haben diese APIs keine Auswirkung.

AppTaskContent kann für verschiedene unterstützte Darstellungen erstellt werden:

  • Schrittabfolge: Zeigt schritt-für-Schritt-Fortschritt der Aufgabenausführung an. Verwenden Sie CreateSequenceOfSteps.
  • Miniaturansicht der Vorschau: Zeigt eine Vorschauminiaturansicht der Vorgangsausgabe an. Verwenden Sie CreatePreviewThumbnail.
  • Ergebnis der Textzusammenfassung: Zeigt eine Zusammenfassung des Vorgangsergebnisses mit einer kurzen Textbeschreibung an. Verwenden Sie CreateTextSummaryResult.
  • Generiertes Ressourcenergebnis: Zeigt eine Zusammenfassung des Vorgangsergebnisses mit generierten Ressourcen an. Verwenden Sie CreateGeneratedAssetsResult.

Wenn eine Aufgabe die Aufmerksamkeit des Benutzers benötigt, können zusätzliche Elemente mithilfe von SetQuestion, AddButton oder SetTextInput hinzugefügt werden.

Verwenden von Shellaufgaben-APIs

Apps, die diese APIs verwenden, müssen gepackt werden. Weitere Informationen finden Sie unter "Paketübersicht ".

Außerdem müssen Sie ihrem App-Manifest wie folgt die com.microsoft.apptaskproviderAppExtension hinzufügen:

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

Eigenschaften

Name Beschreibung
MaxButtons

Ruft die maximale Anzahl von Schaltflächen ab, die aufgabeninhalt hinzugefügt werden können.

Methoden

Name Beschreibung
AddButton(String, Uri)

Fügt dem Aufgabeninhalt eine Schaltfläche hinzu, auf die der Benutzer klicken kann, um eine Aktion auszuführen.

CreateGeneratedAssetsResult(AppTaskResultAsset[])

Erstellt Aufgabeninhalte, die eine Sammlung von Ressourcen anzeigen, die von der Aufgabe generiert werden.

CreatePreviewThumbnail(Uri, String)

Erstellt Aufgabeninhalte, die eine Vorschauminiaturansicht der Aufgabenausgabe anzeigen.

CreateSequenceOfSteps(String[], String)

Erstellt Aufgabeninhalte, die eine Abfolge von Schritten anzeigen, die den Vorgangsfortschritt anzeigen.

CreateTextSummaryResult(String)

Erstellt Aufgabeninhalte, die eine Textzusammenfassung des Vorgangsergebnisses anzeigen.

SetQuestion(String)

Legt eine Frage fest, die dem Benutzer angezeigt werden soll, wenn die Aufgabe Aufmerksamkeit benötigt.

SetTextInput(String, String)

Richtet ein Texteingabefeld für den Benutzer ein, um eine Freiformtextantwort bereitzustellen.

Gilt für: