Freigeben über

Passen Sie den Kopfbereich des Widgets an

  • Artikel

In der neuesten Version können Apps, die Windows-Widgets implementieren, 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),.

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

Überschreiben der Anzeigenamen-Zeichenfolge

Sie können den Wert, der im DisplayName-Element des App-Manifests angegeben ist, überschreiben, indem Sie ein header-Feld mit dem neuen Anzeigenamen in die JSON-Nutzlast einfü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": [
        ...
    ] ,
    "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": [
        ...
    ] ,
    "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 die Kopfzeile leer lassen, indem Sie den header-Wert 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": [
        ...
    ] ,
    "header": null
}