Dostosowywanie obszaru nagłówka widżetu

Aplikacje obsługujące widżety systemu Windows mogą dostosowywać nagłówek wyświetlany dla ich widżetu w panelu Widżety, zastępując domyślny sposób wyświetlania. Dostosowywanie nagłówka jest implementowane w ładunku karty adaptacyjnej przekazywanym z dostawcy widżetu do systemu operacyjnego, dlatego procedura jest taka sama niezależnie od języka, w którym zaimplementowano dostawcę widżetu. Aby zapoznać się z przewodnikiem tworzenia dostawcy widżetu, zobacz Implementowanie dostawcy widżetów w aplikacji systemu Windows w języku C# lub Implementowanie dostawcy widżetu w aplikacji win32 (C++/WinRT).

Dostosowywanie nagłówka zależy od obsługi hosta. Właściwość $host.isHeaderSupported template wskazuje, czy host ją obsługuje; zobacz Właściwości hosta widżetów systemu Windows. Pole header to rozszerzenie widżetu systemu Windows do ładunku danych karty. Zweryfikuj jego prezentację na tablicy widżetów, nie tylko w projektancie ogólnego przeznaczenia Adaptive Cards.

Domyślny nagłówek

Domyślnie nagłówek widżetu wyświetla nazwę wyświetlaną i ikonę określoną w pliku manifestu aplikacji. Nazwa wyświetlana jest określana za pomocą atrybutu DisplayName elementu Definition , a ikona jest określona za pomocą elementu Icon w obszarze ThemeResources. Aby uzyskać więcej informacji na temat formatu pliku manifestu aplikacji widżetu, zobacz Format XML manifestu pakietu dostawcy widżetów.

Poniższy przykład przedstawia część ładunku JSON karty adaptacyjnej dla widżetu korzystającego z prezentacji domyślnej. W poniższych sekcjach zostaną podane przykłady, które zmodyfikują ten szablon, aby zastąpić domyślny nagłówek.

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

Zastąpij ciąg nazwy wyświetlanej

Można zastąpić wartość określoną przez atrybut DisplayName w manifeście aplikacji, dodając pole header z nową nazwą wyświetlaną do ładunku JSON przed wysłaniem go do hosta widżetu.

W poniższym przykładzie pokazano zastępowanie ciągu nazwy wyświetlanej.

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

Zastąp ciąg nazwy wyświetlanej i ikonę

Aby zastąpić zarówno ciąg nazwy wyświetlanej, jak i ikonę header określoną w manifeście aplikacji, dodaj obiekt z polami dla text i iconUrl.

W poniższym przykładzie pokazano zastąpienie ciągu nazwy wyświetlanej i ikony.

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

Ustaw nagłówek na pusty

Niektórzy dostawcy widżetów mogą chcieć zezwolić na rozszerzenie całego doświadczenia użytkownika do obszaru nagłówka widżetu, mimo że ten obszar widżetu jest nieinteraktywny. W tym scenariuszu można ustawić nagłówek jako pusty, ustawiając pole header na wartość null. Pamiętaj, że środowisko użytkownika w nagłówku nie jest klikalne przez użytkownika.

W poniższym przykładzie pokazano ustawienie pustego nagłówka.

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