Widgetanbieter

Windows Widgets sind kleine UI-Container, die Inhalte anzeigen, die von einer Windows App oder Progressive Web App (PWA) bereitgestellt werden. Sie können eine Adaptive-Card-Vorlage und Daten bereitstellen oder ein Web-Widget verwenden, um HTML aus einer URL anzuzeigen. Web-Widgets verwenden weiterhin eine Adaptive-Card-JSON-Payload, um die Inhalts-URL anzugeben.

Für eine verpackte Desktop-App implementieren Sie einen Widgetanbieter, der auf Anforderungen vom Widgethost antwortet und Updates über WidgetManager sendet. Ein PWA verwendet die Widgetdefinitionen im Web-App-Manifest und behandelt Widgetereignisse in seinem Service Worker.

Eine Übersicht über die Windows Widgets-Erfahrung und Entwurfsanleitung zum Erstellen Eigener Widgets finden Sie unter Windows Widgets.

Derzeit können Sie einen Widgetanbieter mithilfe eines Win32-Desktop-App-Pakets oder einer progressiven Web-App (PWA) implementieren. Weitere Informationen finden Sie unter:

ApIs und Funktionen des Desktop-Widget-Anbieters

Implementieren Sie IWidgetProvider für die Erstellung, Löschung, Aktivierung, Kontextänderungen und Benutzeraktionen. Die Basisschnittstelle bleibt erforderlich, wenn Sie optionale Schnittstellen für Anpassungen oder Webinhalte hinzufügen.

Fähigkeit API oder Anleitung Availability
Widget-Lebenszyklus und Adaptive-Card-Updates IWidgetProvider und WidgetManager Windows App SDK 1.2
Benutzeranpassung IWidgetProvider2 und das IsCustomizable-Attribut des Manifests Windows App SDK 1.4
Webinhalte, Ressourcenanforderungen und Messaging Web-Widget-Anbieter, IWidgetResourceProvider, IWidgetProviderMessage und WidgetManager.SendMessageToContent Windows App SDK 1.6.3; überprüfen Sie auch den Web-Widget-Host und regionale Anforderungen.
Inhalte anzeigen, die noch nicht personalisiert oder umsetzbar sind WidgetUpdateRequestOptions.IsPlaceholderContent Windows App SDK 1.6.6
Widget-Analytics-Callbacks IWidgetProviderAnalytics Das Windows Widgets Board unterstützt diese Callbacks ab Windows 11 Build 26900. Andere Hosts müssen auch die Schnittstelle unterstützen; siehe die API-Hinweise.

Die SDK-Versionen identifizieren, wann APIs verfügbar wurden, nicht welches Release Sie installieren sollten. Verwenden Sie eine derzeit unterstützte stabile Version aus den Releasekanälen von Windows App SDK, und testen Sie die Funktionen, die Sie auf Ihrem Windows-Zielgerät und im Widgethost verwenden. Informationen zu Darstellungsoptionen für die Kopfzeile finden Sie unter Anpassen des Kopfzeilenbereichs im Widget. Die PWA-Service-Worker-API ist ein separater Implementierungspfad; die Desktopschnittstellen in dieser Tabelle gelten nicht für sie.

Der Widgethost kann Ihren Anbieter unabhängig von der Lebensdauer von angehefteten Widgets aktivieren und freigeben. Stellen Sie den Widgetstatus wieder her, wenn der Anbieter gestartet wird, und bewahren Sie keine Rückrufargumentobjekte auf, nachdem ein IWidgetProvider-Rückruf beendet wurde. Weitere Informationen finden Sie in den IWidgetProvider-Hinweisen.

Die vollständige API-Referenz finden Sie im Microsoft.Windows. Widgets.Providers-Namespace.

Eine Einführung in die Grundlagen zum Erstellen eines Widgets und zur Implementierung eines Widget-Anbieters finden Sie in der Folge Tabs vs Spaces „Create Widgets for Windows 11“.

Weitere Ressourcen

  • Zuletzt aktualisiert um