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

V nejnovější verzi mohou aplikace, které implementují widgety pro Windows, přizpůsobit záhlaví jejich widgetů na panelu widgetů a přepsat tak výchozí prezentaci. 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, aby záhlaví bylo prázdné, nastavením hodnoty header na 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
}