Anpassa widgetens sidhuvudområde

Appar som implementerar Windows widgetar kan anpassa rubriken som visas för widgeten i Widgets Board, vilket åsidosätter standardpresentationen. Sidhuvudanpassning implementeras i nyttolasten Adaptive Card som du skickar till operativsystemet från widgetprovidern, så stegen är desamma oavsett vilket språk widgetprovidern implementeras i. En genomgång av hur du skapar en widgetprovider finns i Implementera en widgetprovider i en C#-Windows-app eller Implementera en widgetprovider i en win32-app (C++/WinRT).

Anpassning av sidhuvud beror på stöd från värden. Mallegenskapen $host.isHeaderSupported anger om värden stöder den. Se Egenskaper för Windows-widgetvärd. Fältet header är ett Windows-widgettillägg till kortets payload. Verifiera dess presentation i Widgets Board, inte bara i den allmänna designern Adaptive Cards Designer.

Den förvalda standardrubriken

Som standard visar widgetrubriken visningsnamnet och ikonen som anges i appmanifestfilen. Visningsnamnet anges med attributet DisplayName för elementet Definition och ikonen anges med ett Icon-element under ThemeResources. Mer information om manifestfilformatet för widgetappen kan du hitta i XML-format för widgetprovider-paketets manifest.

Följande exempel visar en del av det adaptiva kortets JSON-nyttolast för en widget som använder standardpresentationen. I avsnitten nedan visas exempel som ändrar den här mallen så att standardrubriken åsidosätts.

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

Åsidosätt visningsnamnsträngen

Du kan åsidosätta värdet som anges av attributet DisplayName i appmanifestet genom att lägga till ett header fält med det nya visningsnamnet i JSON-nyttolasten innan du skickar det till widgetvärden.

I följande exempel visas hur du åsidosättar visningsnamnsträngen.

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

Åsidosätt visningsnamnsträngen och ikonen

Om du vill åsidosätta både visningsnamnsträngen och ikonen som anges i appmanifestet lägger du till ett header-objekt med fält för text och iconUrl.

I följande exempel visas hur du åsidosättar visningsnamnsträngen och ikonen.

{ 
    "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" 
      } 
  } 

Ange att rubriken ska vara tom

Vissa widgetprovidrar kanske vill tillåta att deras fullständiga UX expanderar till rubrikregionen för widgeten, även om det här området i widgeten inte kan användas. I det här scenariot kan du ange att rubriken ska vara tom genom att ange fältet header till null. Observera att användargränssnittet i rubriken inte kan klickas av användaren.

Följande exempel visar hur du anger en tom rubrik.

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