Rendern von Karten in Ihrer Anwendung

Es ist einfach, adaptive Karten in Ihrer Anwendung zu rendern. Wir bieten SDKs für alle gängigen Plattformen sowie eine detaillierte Spezifikation zum Erstellen Ihres eigenen adaptiven Kartenrenderers.

1. Installieren Sie ein Renderer-SDK für Ihre Zielplattform.
2. Erstellen Sie eine Rendererinstanz , die mit den Ereignishandlern für Stil, Regeln und Aktionen ihrer App konfiguriert ist.
3. Rendern einer Karte auf der nativen Benutzeroberfläche – automatisch Ihrem App-Design angepasst.

SDKs für adaptive Karten

Plattform	Installieren	Bauen	Doktoren	Der Status
JavaScript		Quelle	Dokumentation
.NET WPF		Quelle	Dokumentation
.NET HTML		Quelle	Dokumentation
Windows UWP		Quelle	Dokumentation
WinUI 3		Quelle	Dokumentation
Android		Quelle	Dokumentation
Ios		Quelle	Dokumentation

Erstellen einer Instanz des Renderers

Der nächste Schritt besteht darin, eine Instanz einer AdaptiveCardRenderer.

Aktionsereignisse verknüpfen

Standardmäßig werden die Aktionen als Schaltflächen auf der Karte gerendert, aber es liegt an Ihrer App, dass sie sich wie erwartet verhalten. Jedes SDK weist das Äquivalent eines OnAction Ereignisses auf, das Sie behandeln müssen.

• Action.OpenUrl - öffnen Sie die angegebene url.
• Action.Submit - das Ergebnis der Übermittlung nehmen und an die Quelle senden. Wie Sie sie an die Quelle der Karte senden, liegt ganz bei Ihnen.
• Action.ShowCard - ruft ein Dialogfeld auf und rendert die Unterkarte in diesem Dialogfeld. Beachten Sie, dass Sie dies nur behandeln müssen, wenn ShowCardActionMode auf popup gesetzt ist.

Rendern einer Karte

Rufen Sie nach dem Abrufen einer Kartennutzlast einfach den Renderer auf und übergeben Sie die Karte. Sie erhalten ein systemeigenes UI-Objekt, das aus dem Karteninhalt besteht. Platzieren Sie diese Benutzeroberfläche nun an einer beliebigen Stelle in Ihrer App.

Anpassung

Es gibt mehrere Möglichkeiten, wie Sie das Rendern anpassen können.

Hostkonfiguration

Ein HostConfig ist ein freigegebenes, plattformübergreifendes Konfigurationsobjekt, das die grundlegende Formatierung und das Verhalten von Karten in Ihrer App steuert. Es definiert Elemente wie Schriftgrade, Abstand zwischen Elementen, Farben, Anzahl der unterstützten Aktionen usw.

Native Plattform-Design

Die meisten Benutzeroberflächenframeworks ermöglichen es Ihnen, die gerenderte Karte mithilfe des nativen Benutzeroberflächenframeworks zu formatieren. In HTML können Sie z. B. CSS-Klassen angeben oder in XAML ein benutzerdefiniertes ResourceDictionary für eine differenzierte Steuerung der Ausgabe übergeben.

Anpassen des Renderings pro Element

Jedes SDK ermöglicht es Ihnen, das Rendering eines beliebigen Elements außer Kraft zu setzen oder sogar Unterstützung für vollständig neue Elemente hinzuzufügen, die Sie definieren. Zum Beispiel können Sie den Input.Date Renderer so ändern, dass Ihr eigenes benutzerdefiniertes Steuerelement ausgegeben wird, während der Rest der Ausgabe des Renderers beibehalten wird. Sie können auch Unterstützung für ein benutzerdefiniertes Rating Element hinzufügen, das Sie definieren.