Het koptekstgebied van de widget aanpassen

In de nieuwste release kunnen apps die Windows-widgets implementeren, de koptekst aanpassen die wordt weergegeven voor hun widget in het widgetsbord, waardoor de standaardpresentatie wordt overschreven. Aanpassing van headers wordt geïmplementeerd in de payload van de Adaptive Card die u doorgeeft aan het besturingssysteem van uw widget-aanbieder, dus de stappen zijn hetzelfde, ongeacht de taal waarin uw widget-aanbieder is geïmplementeerd. Zie Een widgetprovider implementeren in een C# Windows-app of een widgetprovider implementeren in een win32-app (C++/WinRT) voor een overzicht van het maken van een widgetprovider.

De standaardkoptekst

De widgetkop bevat standaard de weergavenaam en het pictogram dat is opgegeven in het manifestbestand van de app. De weergavenaam wordt opgegeven met het kenmerk DisplayName van het definitie-element en het pictogram wordt opgegeven met een pictogramelement onder ThemeResources. Zie de XML-indeling van het pakketmanifest voor widgetproviders voor meer informatie over de manifestbestandsindeling van de widget-app.

In het volgende voorbeeld ziet u een deel van de JSON-nettolading van adaptieve kaart voor een widget die gebruikmaakt van de standaardpresentatie. In de onderstaande secties worden voorbeelden gegeven die deze sjabloon wijzigen om de standaardkoptekst te overschrijven.

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

De tekenreeks voor de weergavenaam overschrijven

U kunt de waarde die is opgegeven in het element DisplayName in het app-manifest overschrijven door een header veld toe te voegen aan de nieuwe weergavenaam in de JSON-nettolading voordat u deze naar de widgethost verzendt.

In het volgende voorbeeld ziet u hoe u de tekenreeks voor de weergavenaam overschrijft.

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

De weergavenaamtekenreeks en het pictogram overschrijven

Als u zowel de weergavenaamtekenreeks als het pictogram dat is opgegeven in het app-manifest wilt overschrijven, voegt u een header object toe met velden voor text en iconUrl.

In het volgende voorbeeld ziet u hoe u de tekenreeks en het pictogram van de weergavenaam overschrijft.

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

Stel de koptekst in als leeg

Sommige widgetproviders willen mogelijk hun volledige UX uitbreiden naar de koptekstregio van de widget, zelfs als dit gebied van de widget niet kan worden uitgevoerd. Voor dit scenario kunt u instellen dat de header leeg is door het header gevoel in te stellen op null. Houd er rekening mee dat de UX in de header niet door de gebruiker kan worden geklikt.

In het volgende voorbeeld ziet u hoe u een lege koptekst instelt.

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