Poskytovatelé widgetů

Windows widgety jsou malé kontejnery uživatelského rozhraní, které zobrazují obsah poskytnutý aplikací Windows nebo progresivní webovou aplikací (PWA). Můžete zadat šablonu adaptivní karty a data nebo použít webový widget k zobrazení HTML z adresy URL. Webové widgety stále používají datovou část JSON adaptivní karty k určení adresy URL obsahu.

U zabalené desktopové aplikace implementujete poskytovatele widgetu, který reaguje na požadavky z hostitele widgetu a odesílá aktualizace prostřednictvím WidgetManager. PWA používá definice widgetů v manifestu webové aplikace a zpracovává události widgetu ve svém service workeru.

Přehled prostředí widgetů Windows a pokyny k návrhu pro vytváření vlastních widgetů najdete v tématu Windows widgety.

V současné době můžete implementovat poskytovatele widgetu pomocí zabalené desktopové aplikace Win32 nebo progresivní webové aplikace (PWA). Další informace najdete tady:

Rozhraní API a možnosti poskytovatele desktopových widgetů

Implementujte IWidgetProvider pro vytváření, odstraňování, aktivaci, změny kontextu a uživatelské akce. Základní rozhraní zůstává povinné při přidání volitelných rozhraní pro přizpůsobení nebo webový obsah.

Schopnost Rozhraní API nebo pokyny Availability
Životní cyklus widgetu a aktualizace adaptivní karty IWidgetProvider a WidgetManager Windows App SDK 1.2
Přizpůsobení uživatele IWidgetProvider2 a atribut IsCustomizable manifestu Windows App SDK 1.4
Webový obsah, požadavky na prostředky a zasílání zpráv Poskytovatelé webových widgetů, IWidgetResourceProvider, IWidgetProviderMessage a WidgetManager.SendMessageToContent Windows App SDK 1.6.3; zkontrolujte také požadavky na hostitele webových widgetů a místní požadavky.
Označuje obsah, který ještě není přizpůsobený nebo použitelný WidgetUpdateRequestOptions.IsPlaceholderContent Windows App SDK 1.6.6
Callbacky analýzy widgetů IWidgetProviderAnalytics Panel widgetů Windows podporuje tato zpětná volání počínaje Windows 11 buildem 26900. Ostatní hostitelé musí také podporovat rozhraní; viz poznámky k rozhraní API.

Verze sady SDK identifikují, kdy byla rozhraní API dostupná, a ne které vydání byste měli nainstalovat. Použijte aktuálně podporovanou stabilní verzi z kanálů vydání Windows App SDK a otestujte možnosti, které používáte na cílovém zařízení se systémem Windows a hostiteli widgetů. Možnosti prezentace záhlaví viz Přizpůsobení oblasti záhlaví widgetu. PWA service-worker API je samostatná implementační cesta; desktopová rozhraní v této tabulce se na ni nevztahují.

Hostitel widgetů může aktivovat a uvolnit vašeho poskytovatele nezávisle na životnosti připnutých widgetů. Obnovte stav widgetu při spuštění zprostředkovatele a nezachovávejte objekty argumentů zpětného volání po vrácení zpětného volání IWidgetProvider . Další informace naleznete v poznámkách IWidgetProvider.

Úplné referenční informace k rozhraní API najdete v oboru názvů Microsoft.Windows.Widgets.Providers

Návod k základům vytváření widgetu a implementaci poskytovatele widgetů najdete v epizodě "Vytvoření widgetů pro Windows 11".

Dodatečné zdroje

  • Poslední aktualizace v