Vývoj widgetů a řídicích panelů Windows

Pomůcky

Windows widgety jsou malé kontejnery uživatelského rozhraní přidružené k nainstalované aplikaci. Panel widgetů je zobrazí v mřížce na ploše Windows s přizpůsobeným obsahem a rychlými akcemi z vaší aplikace. Obsah můžete definovat pomocí Adaptivní karty, které vážou data na šablonu JSON, nebo zobrazit kód HTML z adresy URL s poskytovatelem webového widgetu. Webové widgety stále používají datovou část JSON adaptivní karty k určení adresy URL obsahu.

Pokyny k návrhu najdete v tématu Windows Přehled návrhu widgetů.

Zvolte vývojovou cestu widgetu

Pomocí této tabulky vyberte cestu implementace a další téma, které se má otevřít.

Pokud chcete...	Použití tohoto přístupu	Začněte tady
Přidání widgetu adaptivní karty do zabalené desktopové aplikace C#	Implementujte IWidgetProvider, odešlete aktualizace šablony a dat pomocí WidgetManager a zaregistrujte zprostředkovatele prostřednictvím manifestu balíčku.	Průvodce poskytovatelem widgetů jazyka C#
Přidejte widget adaptivní karty do zabalené desktopové aplikace C++/WinRT	Implementujte IWidgetProvider v COM serveru mimo proces a zaregistrujte jeho identifikátor CLSID a definice widgetu v manifestu balíčku.	Průvodce poskytovatelem widgetů C++/WinRT
Zobrazit HTML z adresy URL v desktopovém widgetu	Použijte poskytovatele webových widgetů. Tato funkce je k dispozici pouze uživatelům v EHP. Poskytovatel stále odesílá datovou část adaptivní karty obsahující webovou adresu URL a náhradní obsah.	Poskytovatelé webových widgetů
Přidat widget pro existující progresivní webovou aplikaci (PWA)	Definujte widget v manifestu webové aplikace a zpracujte události widgetu v service workeru. Toto je oddělené od desktopové cesty IWidgetProvider.	Vytváření widgetů řízených aplikací PWA
Zpracování tlačítka nebo akce formuláře v poskytovateli pro desktop	Použijte Action.Execute a zpracujte příkaz v OnActionInvoked. Zobrazit pouze v případech, kdy $host.isUserContextAuthenticated je pravda.	Vytvořte šablonu widgetu
Otevřete stránku aplikace nebo web bez zpětného volání poskytovatele	Použijte Action.OpenUrl. Zůstane k dispozici, pokud kontext uživatele widgetu není autentizován.	Vytvoření šablony widgetu
Umožněte uživatelům konfigurovat widget	Implementujte IWidgetProvider2, nastavte atribut IsCustomizable manifestu a zadejte datovou část pro přizpůsobení.	Implementujte přizpůsobení widgetu
Přizpůsobte obsah pro velikost, motiv, nastavení, hlavičku, podporu webu nebo ověřování	Použijte vlastnosti Windows $host v šabloně adaptivní karty a deklarujte každou podporovanou velikost v manifestu balíčku.	vlastnosti hostitele widgetu Windows
Zobrazit načítaný obsah nebo obsah po odhlášení	Odešlete záměrně záložní šablonu a data. Nastavte IsPlaceholderContent, pokud obsah ještě není přizpůsobený nebo s ním nelze pracovat.	Poskytovatelé widgetů
Přidat informační kanál řídicího panelu místo jednotlivého widgetu	Implementujte poskytovatele feedu. Poskytovatelé informačních kanálů jsou samostatnou integrací a jsou k dispozici pouze v EHP.	Řídicí panely a poskytovatelé informačních kanálů
Požádejte GitHub Copilot, aby vytvořil a ověřil widget.	Použijte opakovaně použitelný prompt, který vybere podporovanou cestu a vyžaduje ověření balíčku, manifestu, sestavení a Widgets Board.	Vytvořte widget Windows pomocí GitHub Copilot

Dashboards

Poskytovatelé zdrojů registrují kanály obsahu, které se zobrazují jako nástěnky na panelu widgetů. Poskytovatel informačního kanálu je samostatná integrace od poskytovatele widgetu; zobrazení HTML ve widgetu se nepovažuje za feed řídicího panelu.

Important

Poskytovatelé informačních kanálů jsou k dispozici pouze uživatelům v Evropském hospodářském prostoru (EHP). Požadavky na dostupnost a implementaci najdete v tématu Řídicí panely a poskytovatelé informačních kanálů.

V této části

Téma	Description
Poskytovatelé zdrojů	Zjistěte, jak zaregistrovat informační kanály obsahu aplikace, aby se zobrazovaly přímo na panelu widgetů Windows.
Poskytovatelé widgetů	Zjistěte, jak implementovat poskytovatele widgetů, který poskytuje obsah, rozložení a interaktivní prvky pro vaše widgety.
Poskytovatelé webových widgetů	Zobrazit HTML ve widgetu a zpracovávat požadavky na prostředky a zprávy mezi poskytovatelem a webovým obsahem
Návrhář Adaptivní karty	Projděte si vytvoření šablony widgetu pomocí návrháře Adaptivní karty.
Vytvořte widget Windows pomocí GitHub Copilotu	Pomocí opakovaně použitelného promptu můžete vygenerovat, zabalit a ověřit widget v existujícím úložišti.