Komponente „Implementieren von Auswahlmöglichkeiten (Optionssatz mit Mehrfachauswahl)“

Diese Beispielkomponente zeigt, wie Sie den Typ „Optionssatz mit Mehrfachauswahl“ für Eigenschaften von field-Komponenten nutzen. Durch Binden der primären Eigenschaft der Codekomponente an diesen Typ können Benutzer alle neuen Typen von Steuerelementen mit Auswahlspalten erstellen.

Anmerkung

Das Steuerelement muss an eine Spalte vom Typ MultiSelectOptionSet gebunden sein, damit der dieser Spalte zugeordnete Optionssatz in der Komponente aufgefüllt wird.

Verfügbar für

Modellbasierte Apps

Code

Sie können die komplette Beispielkomponente hier herunterladen.

Im Manifest ist eine einzelne Eigenschaft vom Typ MultiSelectOptionSet definiert. Diese Eigenschaft wird automatisch an den Optionssatz gebunden, der mit der Spalte verknüpft ist, in der die Komponente in der modellgesteuerten App platziert wird.

Diese Komponente rendert ein Standardelement select mit Optionen für jeden Wert im Optionssatz und einer Textspalte zum Anzeigen aller aktuell ausgewählten Optionen. Der erneute onClick-Aufruf eines jeden Werts ist auf die Methode updateIndividualSelected festgelegt, die in dieser Komponente definiert ist. Diese Methode fügt die ausgewählte Option entweder hinzu oder entfernt sie und ruft dann notifyOutputChanged auf, um dem Framework mitzuteilen, dass sich die Daten geändert haben.

Für MultiSelectOptionSets hat jede Option einen Anzeigenamen für den Wert sowie einen damit verbundenen numerischen Wert. Um die aktuell ausgewählten Optionen zu verfolgen, verwaltet das Steuerelement ein Array der Werte aller aktuell ausgewählten Optionen. Diese Methode besteht darin, sich an dem auszurichten, was PCF vom Steuerelement für MultiSelectOptionSet in getOutputs zurückerwartet.

Die Methode getOutputs gibt einfach den aktuell ausgewählten Satz von Werten an das Framework zurück, damit es aktualisiert wird. In der Methode updateView aktualisiert die Komponente einfach den Inhalt der Textbeschriftung selected options zum Ausrichten mit dem neuesten Wert, der vom Framework über den formatierten Wert der Eigenschaft MultiSelectOptionSet empfangen wurde.

Ähnliche Artikel

Beispielkomponenten herunterladen
Beispielkomponenten verwenden
Power Apps component framework-API-Referenz
Power Apps component framework – Manifestschemareferenz