AppTaskContent Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- 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. |