A widget fejlécterületének testreszabása

A legújabb kiadásban a Windows-vezérlőket implementáló alkalmazások testre szabhatják a widgethez megjelenített fejlécet a Widgets Boardban, felülírva az alapértelmezett bemutatót. A fejléc testreszabását az adaptív kártya payloadjában valósítják meg, amelyet a widget-szolgáltató az operációs rendszerhez juttat el, így a lépések ugyanazok, függetlenül attól, hogy a widget-szolgáltatót milyen nyelven valósították meg. A widget-szolgáltató létrehozásáról további információt a Widget-szolgáltató implementálása c# Windows-alkalmazásban vagy widgetszolgáltató implementálása win32-alkalmazásokban (C++/WinRT) című témakörben talál.

Az alapértelmezett fejléc

A widget fejléce alapértelmezés szerint az alkalmazásjegyzékfájlban megadott megjelenítendő nevet és ikont jeleníti meg. A megjelenítendő név a Definíció elem DisplayName attribútumával van megadva, az ikon pedig a ThemeResources alatt található Ikon elemet tartalmazza. A widgetalkalmazás jegyzékfájl-formátumával kapcsolatos további információkért tekintse meg a widget-szolgáltató csomagjegyzékének XML-formátumát.

Az alábbi példa az adaptív kártya JSON fájl egy részét mutatja be a widget alapértelmezett megjelenítéssel. Az alábbi szakaszokban olyan példákat talál, amelyek a sablont úgy módosítják, hogy felülbírálják az alapértelmezett fejlécet.

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

A megjelenített név sztringjének felülbírálása

Az alkalmazásjegyzék DisplayName elemében megadott értéket felülbírálhatja úgy, hogy hozzáad egy header mezőt az új megjelenítendő névvel a JSON-adatcsomagban, mielőtt elküldené azt a widget-gazdagépnek.

Az alábbi példa a megjelenítendő név sztring felülírását mutatja be.

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

A megjelenített név string és ikon felülírása

Ha felül szeretné bírálni a megjelenítendő nevet és az alkalmazásjegyzékben megadott ikont is, adjon hozzá egy header objektumot, amely tartalmaz mezőket mind a text , mind a iconUrl számára.

Az alábbi példa a megjelenítendő név sztringjének és ikonjának felülírását mutatja be.

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

A fejléc üresre állítása

Előfordulhat, hogy egyes widgetszolgáltatók szeretnék engedélyezni a teljes UX-t a widget fejlécrégiójába, annak ellenére, hogy a widget ezen területe nem használható. Ebben a helyzetben úgy állíthatja be a fejlécet üresre, hogy az header érzetet null-re állítja. Vegye figyelembe, hogy a felhasználó nem kattint a fejlécben lévő UX-ra.

Az alábbi példa egy üres fejléc beállítását mutatja be.

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