AppTaskInfo Klasse

Definition

Namespace:: Windows.UI.Shell.Tasks

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.

Bearbeiten

Stellt eine App-Aufgabe dar, die in der Windows-Shell angezeigt werden kann.

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

Vererbung: Object Platform::Object IInspectable AppTaskInfo

Attribute: ContractVersionAttribute ExperimentalAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Diese Klasse unterstützt das Erstellen, Aktualisieren und Entfernen von Aufgabendarstellungen. Aufgaben werden in App-Sitzungen und Systemneustarts beibehalten.

Erstellen Sie für jede Aufgabe eine neue AppTaskInfo Instanz, und ändern Sie sie so, dass sie den Aufgabenstatus darstellt. Wenn eine Aufgabe nicht mehr relevant ist, rufen Sie "Entfernen" auf, um sie aus der Shell zu entfernen.

Verwenden Sie IsSupported , um zu überprüfen, ob das Feature verfügbar ist, bevor Sie versuchen, Aufgaben zu erstellen oder auflisten. Verwenden Sie FindAll zum Aufzählen vorhandener Aufgaben, die zuvor erstellt wurden.

Aufgaben können von Benutzern über die Taskleistenschnittstelle ausgeblendet werden. Das Ausblenden einer Aufgabe wirkt sich nicht auf die in der App ausgeführte Aufgabe aus. Ihre Darstellung wird einfach aus der Taskleiste entfernt. Die HiddenByUser-Eigenschaft gibt an, ob eine Aufgabe vom Benutzer ausgeblendet wurde.

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
DeepLink	Ruft einen URI ab, der ausgeführt wird, wenn der Benutzer auf die Shell-Darstellung der Aufgabe klickt.
EndTime	Ruft den Zeitpunkt ab, zu dem dieser Vorgang einen Endzustand erreicht hat (z `Completed` . B. oder `Error`).
HiddenByUser	Ruft einen Wert ab, der angibt, ob der Benutzer diese Aufgabe über die Windows-Shell ausgeblendet hat.
IconUri	Ruft den Pfad zu einem Symbol ab, das die Aufgabe darstellt.
Id	Ruft den automatisch generierten eindeutigen Bezeichner für diese Aufgabe ab.
StartTime	Ruft die Zeit ab, zu der diese Aufgabe erstellt wurde.
State	Ruft den aktuellen Status dieser Aufgabe ab.
Subtitle	Ruft den Untertitel dieser Aufgabe ab.
Title	Ruft den Titel dieser Aufgabe ab.

Methoden

Name	Beschreibung
Create(String, String, Uri, Uri, AppTaskContent)	Erstellt eine neue App-Aufgabe mit den angegebenen Parametern.
FindAll()	Gibt alle App-Aufgaben zurück, die von der aktuellen Anwendung erstellt wurden.
GetCompletedSteps()	Ruft die Abfolge der Schritte ab, die für diese Aufgabe abgeschlossen wurden.
GetExecutingStep()	Ruft den Schritt ab, der derzeit für diese Aufgabe ausgeführt wird.
IsSupported()	Ruft einen Wert ab, der angibt, ob das App-Aufgabenfeature auf dem aktuellen Gerät unterstützt wird.
Remove()	Entfernt diese Aufgabe aus der Windows-Shell, ändert jedoch nicht den Zustand.
Update(AppTaskState, AppTaskContent)	Aktualisiert sowohl den Status als auch den Inhalt dieser Aufgabe.
UpdateDeepLink(Uri)	Aktualisiert den Deep Link-URI für diese Aufgabe.
UpdateState(AppTaskState)	Aktualisiert den Status dieser Aufgabe, ohne dessen Inhalt zu ändern.
UpdateTitles(String, String)	Aktualisiert den Titel und Untertitel dieser Aufgabe.

Gilt für:

Feedback

War diese Seite hilfreich?