Windows Widgets en dashboards ontwikkelen

Widgets

Windows widgets zijn kleine UI-containers die zijn gekoppeld aan een geïnstalleerde app. Het widgetsbord geeft deze weer in een raster op het Windows-bureaublad, met gepersonaliseerde inhoud en snelle acties vanuit uw app. U kunt inhoud definiëren met Adaptieve kaarten, die gegevens binden aan een JSON-sjabloon of HTML weergeven vanuit een URL met een webwidgetprovider. Webwidgets gebruiken nog steeds een Adaptive Card JSON-payload om de inhouds-URL op te geven.

Zie Windows Widgets design overview voor ontwerprichtlijnen.

Een widgetontwikkelingspad kiezen

Gebruik deze tabel om het implementatiepad en het volgende onderwerp te selecteren dat u wilt openen.

Als je wilt...	Gebruik deze methode	Begin hier
Een adaptieve kaartwidget toevoegen aan een verpakte C#-bureaublad-app	Implementeer IWidgetProvider, verzend sjabloon- en gegevensupdates met WidgetManager en registreer de provider via het pakketmanifest.	Stapsgewijze handleiding voor de C#-widgetprovider
Een adaptieve kaartwidget toevoegen aan een verpakte C++/WinRT-bureaublad-app	Implementeer IWidgetProvider in de out-of-process COM-server en registreer de CLSID- en widgetdefinities in het pakketmanifest.	Stapsgewijze handleiding voor C++/WinRT-widgetprovider
HTML weergeven vanuit een URL in een bureaubladwidget	Gebruik een webwidgetprovider. Deze functie is alleen beschikbaar voor gebruikers in de EER. De provider verzendt nog steeds een payload van een Adaptive Card met de web-URL en fallbackinhoud.	Webwidgetproviders
Een widget toevoegen voor een bestaande Progressive Web App (PWA)	Definieer de widget in het manifest van de web-app en verwerk widget-gebeurtenissen in de service worker. Dit staat los van het desktoppad IWidgetProvider.	PWA-gestuurde widgets maken
Een knop- of formulieractie afhandelen in uw desktopprovider	Gebruik Action.Execute en verwerk het werkwoord in OnActionInvoked. Alleen weergeven wanneer $host.isUserContextAuthenticated waar is.	Een widgetsjabloon maken
Een app-pagina of -website openen zonder callback van een provider	Gebruik Action.OpenUrl. Dit blijft beschikbaar wanneer de gebruikerscontext van de widget niet is geauthenticeerd.	Een widgetsjabloon maken
Gebruikers een widget laten configureren	Implementeer IWidgetProvider2, stel het kenmerk IsCustomizable van het manifest in en geef een aanpassingspayload op.	Widgetaanpassing implementeren
Inhoud aanpassen voor grootte, thema, instellingen, koptekst, webondersteuning of verificatie	Gebruik Windows $host-eigenschappen in de sjabloon voor Adaptive Card en geef elke ondersteunde grootte op in het pakketmanifest.	Eigenschappen van de Windows-widget-host
Inhoud laden of afgemelde inhoud weergeven	Verzend een fallbacksjabloon en gegevens opzettelijk. Stel IsPlaceholderContent in als inhoud nog niet gepersonaliseerd is of bruikbaar voor actie.	Aanbieders van widgets
Een dashboardfeed toevoegen in plaats van een afzonderlijke widget	Implementeer een feedprovider. Feedproviders zijn een afzonderlijke integratie en zijn alleen beschikbaar in de EER.	Dashboards en feedaanbieders
Vraag GitHub Copilot om een widget te maken en te valideren	Gebruik de herbruikbare prompt, die een ondersteund pad selecteert en pakket-, manifest-, build- en Widgets Board-validatie vereist.	Een Windows widget maken met GitHub Copilot

Dashboards

Feedproviders registreren contentfeeds die worden weergegeven als dashboards op het Widgets Board. Een feedprovider is een aparte integratie dan een widgetprovider; als HTML in een widget wordt weergegeven, wordt er geen dashboardfeed geregistreerd.

Important

Feedproviders zijn alleen beschikbaar voor gebruikers in de Europese Economische Ruimte (EER). Zie Dashboards en feedproviders voor beschikbaarheid en implementatievereisten.

In deze sectie

Onderwerp	Beschrijving
Feedproviders	Meer informatie over het registreren van de inhoudsfeeds van uw app die rechtstreeks in het Windows Widgetsbord worden weergegeven.
Aanbieders van widgets	Informatie over het implementeren van een widgetprovider die inhoud, indeling en interactieve elementen voor uw widgets levert.
Webwidgetproviders	HTML weergeven in een widget en resourceaanvragen en berichten verwerken tussen uw provider en webinhoud.
Adaptieve kaarten Designer	Doorloop het maken van een widgetsjabloon met behulp van de Adaptieve kaarten Designer.
Een Windows widget maken met GitHub Copilot	Gebruik een herbruikbare prompt om een widget te genereren, te verpakken en te valideren in een bestaande repository.