Passen Sie den Kopfbereich des Widgets an

Apps, die Windows Widgets implementieren, können die Kopfzeile anpassen, die für ihr Widget im Widgets Board angezeigt wird, wobei die Standardpräsentation außer Kraft gesetzt wird. Die Header-Anpassung wird im Adaptive-Card-Payload implementiert, das Sie von Ihrem Widget-Anbieter an das Betriebssystem übergeben, sodass die Schritte gleich sind, unabhängig davon, in welcher Sprache Ihr Widget-Anbieter implementiert ist. Eine Schritt-für-Schritt-Anleitung zum Erstellen eines Widgetanbieters finden Sie unter Implementieren eines Widgetanbieters in einer C# Windows-App, oder Implementieren eines Widgetanbieters in einer Win32-App (C++/WinRT),.

Die Headeranpassung hängt von der Hostunterstützung ab. Die $host.isHeaderSupported template-Eigenschaft gibt an, ob der Host dies unterstützt. Siehe Windows-Widgethosteigenschaften. Das header Feld ist eine Windows-Widgeterweiterung für den Karten-Payload. Überprüfen Sie ihre Darstellung im Widgets Board, nicht nur im allgemeinen Adaptive-Karten-Designer.

Der Standardheader

Standardmäßig zeigt der Widgetheader den Anzeigenamen und das in der App-Manifestdatei angegebene Symbol an. Der Anzeigename wird mit dem DisplayName-Attribut des Definition-Elements angegeben, und das Symbol wird über ein Icon-Element unter ThemeResources angegeben. Weitere Informationen zum Manifestdateiformat der Widget-App finden Sie unter XML-Format des Widgetanbieter-Paketmanifests.

Das folgende Beispiel zeigt einen Teil der JSON-Nutzlast für adaptive Karten für ein Widget, das die Standardpräsentation verwendet. In den folgenden Abschnitten werden Beispiele bereitgestellt, die diese Vorlage so ändern, dass die Standardkopfzeile überschrieben wird.

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

Überschreiben der Anzeigenamen-Zeichenfolge

Sie können den durch das DisplayName-Attribut im App-Manifest angegebenen Wert überschreiben, indem Sie der JSON-Nutzlast ein header Feld mit dem neuen Anzeigenamen hinzufügen, bevor Sie sie an den Widgethost senden.

Das folgende Beispiel veranschaulicht das Überschreiben der Anzeigenamen-Zeichenfolge.

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

Überschreiben der Anzeigename-Zeichenfolge und des Symbols

Um sowohl die Anzeigenamen-Zeichenfolge als auch das im App-Manifest angegebene Symbol außer Kraft zu setzen, fügen Sie ein header-Objekt mit Feldern für text und iconUrl hinzu.

Das folgende Beispiel veranschaulicht das Überschreiben der Anzeigenamen-Zeichenfolge und des Symbols.

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

Festlegen, dass die Kopfzeile leer ist

Einige Widgetanbieter möchten möglicherweise zulassen, dass ihre vollständige Benutzeroberfläche in den Kopfzeilenbereich des Widgets erweitert wird, obwohl dieser Bereich des Widgets nicht handlungsfähig ist. In diesem Szenario können Sie den Header leer lassen, indem Sie das Feld header auf null setzen. Beachten Sie, dass die Benutzererfahrung in der Kopfzeile nicht anklickbar ist.

Im folgenden Beispiel wird das Festlegen einer leeren Kopfzeile veranschaulicht.

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