Widget-providers

Windows widgets zijn kleine UI-containers die inhoud weergeven die wordt geleverd door een Windows app of Progressive Web App (PWA). U kunt een Adaptive Card-sjabloon en -gegevens opgeven of een webwidget gebruiken om HTML van een URL weer te geven. Webwidgets gebruiken nog steeds een Adaptive Card JSON-payload om de inhouds-URL op te geven.

Voor een verpakte bureaublad-app implementeert u een widgetprovider die reageert op aanvragen van de widgethost en updates verzendt via WidgetManager. Een PWA gebruikt de widgetdefinities in het manifest van de web-app en verwerkt widget-gebeurtenissen in de service worker.

Zie Windows widgets voor een overzicht van de ervaring met Windows widgets en ontwerprichtlijnen voor het maken van uw eigen widgets.

Momenteel kunt u een widgetprovider implementeren met behulp van een verpakte Win32-desktop-app of een Progressive Web App (PWA). Zie voor meer informatie:

API’s en mogelijkheden van de provider van bureaubladwidgets

Implementeer IWidgetProvider voor het maken, verwijderen, activeren, contextwijzigingen en gebruikersacties. De basisinterface blijft vereist wanneer u optionele interfaces toevoegt voor aanpassing of webinhoud.

Vermogen API of handleiding Availability
Updates voor levenscyclus van widget en Adaptive Card IWidgetProvider en WidgetManager Windows App SDK 1,2
Aanpassing van gebruikers IWidgetProvider2 en het kenmerk IsCustomizable van het manifest Windows App SDK 1.4
webinhoud, aanvragen voor resources en berichten Web widget providers, IWidgetResourceProvider, IWidgetProviderMessage en WidgetManager.SendMessageToContent Windows App SDK 1.6.3; controleer ook de host van de webwidget en de regionale vereisten.
Inhoud aangeven die nog niet is gepersonaliseerd of bruikbaar voor actie is WidgetUpdateRequestOptions.IsPlaceholderContent Windows App SDK 1.6.6
Callbacks voor analyse van widgets IWidgetProviderAnalytics De Windows Widgets Board ondersteunt deze callbacks vanaf Windows 11 build 26900. Andere hosts moeten ook ondersteuning bieden voor de interface; zie de API-opmerkingen.

De SDK-versies geven aan wanneer API's beschikbaar zijn, niet welke release u moet installeren. Gebruik een momenteel ondersteunde stabiele release van releasekanalen van Windows App SDK en test de mogelijkheden die u gebruikt op uw doel-Windows-apparaat en widgethost. Zie Het koptekstgebied aanpassen voor opties voor de presentatie van de widgetkop. De PWA-service-worker-API is een afzonderlijk implementatiepad; de bureaubladinterfaces in deze tabel zijn hierop niet van toepassing.

De widgethost kan uw provider onafhankelijk van de levensduur van vastgemaakte widgets activeren en vrijgeven. Herstel de widgetstatus wanneer de provider wordt gestart en behoud geen callback-argumentobjecten nadat een IWidgetProvider-callback is teruggekeerd. Zie de opmerkingen van IWidgetProvider voor meer informatie.

Zie de naamruimte Microsoft.Windows.Widgets.Providers voor de volledige API-verwijzing.

Bekijk voor een stapsgewijze uitleg van de basisprincipes van het maken van een widget en het implementeren van een widgetprovider de aflevering van Tabs vs Spaces 'Widgets maken voor Windows 11'.

Aanvullende bronnen

  • Laatst bijgewerkt om