Přizpůsobení oblasti záhlaví widgetu

Aplikace, které implementují widgety systému Windows, mohou přizpůsobit záhlaví, které se pro jejich widget zobrazuje na nástěnce Widgety, a nahradit tak výchozí způsob zobrazení. Přizpůsobení hlaviček se implementuje v datové části adaptivní karty, kterou předáváte operačnímu systému od poskytovatele widgetu, takže postup je stejný bez ohledu na jazyk, ve který je váš poskytovatel widgetu implementovaný. Návod k vytvoření poskytovatele widgetu najdete v tématu Implementace poskytovatele widgetu v aplikace pro Windows v jazyce C# nebo Implementace poskytovatele widgetu v aplikaci win32 (C++/WinRT).

Výchozí hlavička

Ve výchozím nastavení se v záhlaví widgetu zobrazuje zobrazovaný název a ikona zadaná v souboru manifestu aplikace. Zobrazovaný název je zadán atributem DisplayName elementu Definition a ikona je určena elementem Icon v části ThemeResources. Další informace o formátu souboru manifestu aplikace widget naleznete v tématu Formát XML manifestu balíčku poskytovatele widgetu.

Následující příklad ukazuje část datové části JSON adaptivní karty pro widget, který používá výchozí prezentaci. V následujících částech budou uvedeny příklady, jak tuto šablonu modifikovat a změnit tak výchozí hlavičku.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] 
  } 

Přepište řetězec zobrazovaného názvu

Hodnotu zadanou v elementu DisplayName v manifestu aplikace můžete přepsat přidáním pole header s novým zobrazovaným názvem do datové části JSON předtím, než ji odešlete do hostitele widgetu.

Následující příklad ukazuje přepsání zobrazovaného řetězce názvu.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] ,
    "header": "Redmond Weather"
  } 

Přepište zobrazené jméno a ikonu.

Chcete-li přepsat řetězec zobrazovaného názvu i ikonu určenou v manifestu aplikace, přidejte objekt header s poli pro text a iconUrl.

Následující příklad ukazuje přepsání zobrazovaného řetězce názvu a ikony.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] ,
    "header": { 
         "text": "Redmond weather", 
         "iconUrl": "https://contoso.com/weatherimage.png" 
      } 
  } 

Nastavení prázdného záhlaví

Někteří poskytovatelé widgetů můžou chtít povolit, aby se jejich úplná uživatelská rozhraní rozšířila do oblasti záhlaví widgetu, i když tato oblast widgetu není použitelná. V tomto scénáři můžete nastavit záhlaví jako prázdné tím, že pole header nastavíte na hodnotu null. Všimněte si, že uživatel nemůže kliknout na uživatelské rozhraní v záhlaví.

Následující příklad ukazuje nastavení prázdné hlavičky.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] ,
    "header": null
}