Dostosowywanie obszaru nagłówka widżetu

W najnowszej wersji aplikacje, które implementują widżety systemu Windows, mogą dostosowywać nagłówek, który jest wyświetlany dla ich widżetów na Tablicy Widżetów, zastępując domyślną prezentację. 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).

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": [
        ...
    ] 
  } 

Zastąpij ciąg nazwy wyświetlanej

Możesz zastąpić wartość określoną w elemencie DisplayName w manifeście aplikacji, dodając pole header z nową nazwą wyświetlaną w obiekcie JSON przed wysłaniem 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": [
        ...
    ] ,
    "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": [
        ...
    ] ,
    "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ć, że nagłówek będzie pusty, ustawiając wartość header na 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": [
        ...
    ] ,
    "header": null
}