Eigenschaften der Canvas-Komponente

Mit Canvas-Komponenten können Entwickler verschiedene Arten von Eigenschaften erstellen, um Werte oder Logik zwischen der Komponente und der App, die die Komponente hostet, zu übergeben. Eigenschaften sind essenziell für den Bau interaktiver, wiederverwendbarer Komponenten.

Anforderungen

Diese Funktion ist standardmäßig für neue Apps aktiviert. Bei vorhandenen Apps müssen Sie sie in Ihren App-Einstellungen aktivieren.

1. Öffnen Sie Ihre Canvas-App zur Bearbeitung in Power Apps Studio. Wählen Sie in der Befehlsleiste Einstellungen>Updates aus.

2. Suchen Sie auf der Registerkarte Neu die Einstellung Verbesserte Komponenten-Eigenschaften und aktivieren Sie diese.

Typen von Eigenschaften

Den Erstellern stehen vier Typen von Eigenschaften zur Verfügung.

1. Dateneigenschaften: Dateneigenschaften beziehen sich auf Daten wie etwa eine Farbe oder ein Textwert. Eine Daten-Eigenschaft kann auf Eingabe oder Ausgabe festgelegt werden, was angibt, ob die Komponente der App Daten bereitstellt (Ausgabe) oder ob die App der Komponente Daten bereitstellt (Eingabe). Daten-Eigenschaften sind die einzigen Eigenschaften, die am App-Datenfluss beteiligt sind.
2. Funktionseigenschaften: Funktionseigenschaften beziehen sich auf die Logik, z. B. das Durchführen einer Berechnung auf der Grundlage bestimmter Parameter oder das Ändern von Text. Eine Funktion-Eigenschaft kann auf Eingabe oder Ausgabe festgelegt werden, was angibt, ob die Komponente eine Funktion bereitstellt, die die App aufrufen kann (Ausgabe), oder ob die App eine Funktion bereitstellt, die die Komponente aufrufen kann (Eingabe). Funktion-Eigenschaften nehmen nicht am Datenfluss einer App teil und können keine Komponenten- oder App-Variablen verwenden.
3. Aktionseigenschaften: Aktionseigenschaften sind ein Typ von Eigenschaft, der sich mit Logik befasst und sich wie eine Ausgabe-Funktion verhält. Somit ist für die Komponente die Logik definiert, und diese Logik kann verkettete Ausdrücke verwenden und Sammlungen oder Variablen („Verhalten“) manipulieren. Beispielsweise könnte eine Clear()Aktion-Eigenschaft bereitstellen, die die App aufrufen kann, um einige Werte in der Komponente zu löschen, oder eine Save()Aktion-Eigenschaft, die eine Datenquelle aktualisiert.
4. Ereigniseigenschaften: Ereigniseigenschaften sind eine Eigenschaftskategorie, die Logik beinhaltet und als EingabeFunktion fungiert. Somit definiert die App die Logik, die die Komponente aufrufen kann, und diese Logik kann verkettete Ausdrücke verwenden und Sammlungen oder Variablen („Verhalten“) manipulieren. Typischerweise spiegeln die Namen dieser Eigenschaften ein Ereignis wie OnSelect oder OnChanged wider.

Dateneigenschaft

Die Verwendung einer Dateneigenschaft ist leicht vorstellbar. Standardsteuerelemente in Apps verfügen normalerweise über mehrere Dateneigenschaften, um Standardwerte, Textfarbe, Größe usw. festzulegen. Sehen wir uns ein einfaches Beispiel an, bei dem Sie Eigenschaften eines Steuerelements innerhalb der Komponente für die Hosting-App verfügbar machen möchten. In diesem Beispiel heißt die Komponente Component1. Fügen Sie einen Schieberegler in die Komponente ein. Fügen Sie eine Eingabe-Eigenschaft hinzu, um die Farbe der nutzenden App anzugeben, und eine Ausgabe-Eigenschaft, damit die Komponente der App den aktuellen Wert des Schiebereglers mitteilen kann. In diesem Beispiel wird davon ausgegangen, dass die Komponente über ein Schieberegler-Steuerelement mit dem Namen Slider verfügt.

1. Wählen Sie im Eigenschaftsbereich der Komponente Neue benutzerdefinierte Eigenschaft aus.
2. Geben Sie im Bereich Neue benutzerdefinierte Eigenschaft den Anzeigename Slider Color ein.
3. Wählen Sie Eigenschaftstyp von Daten und wählen Sie Eigenschaftsdefinition Wert Eingabe.
4. Wählen Sie schließlich aus der Datentyp-Dropdownliste Farbe aus.
5. Klicken Sie auf Erstellen.

Wählen Sie als Nächstes das Slider1Schieberegler-Steuerelement aus. Suchen Sie nach der Eigenschaft ValueFill und geben Sie in der Bearbeitungsleiste Component1.SliderColor ein. Component1 ist der Name der Komponente und SliderColor der Name der Eigenschaft, die Sie hinzugefügt haben.

Jetzt verfügt die Komponente über eine SliderColor Eigenschaft, die in der konsumierenden App festgelegt werden kann, um eine Farbe an die Komponente zu übergeben und die ValueFill-Eigenschaft des Schiebereglers festzulegen.

Möglicherweise möchten Sie auch den Wert des Schiebereglers für die nutzende App bereitstellen. Dazu fügen Sie eine Ausgabe-Eigenschaft hinzu.

1. Wählen Sie im Eigenschaftsbereich der Komponente Neue benutzerdefinierte Eigenschaft aus.
2. Geben Sie im Bereich Neue benutzerdefinierte Eigenschaft den Anzeigename Slider Value ein.
3. Wählen Sie Eigenschaftstyp von Daten und wählen Sie Eigenschaftsdefinition Wert Ausgabe.
4. Wählen Sie schließlich aus der Datentyp-Dropdownliste Zahl aus.
5. Klicken Sie auf Erstellen.

Wenn eine Daten-Eigenschaft Ausgabe ist, stellt die Komponente den Wert für die nutzende App bereit. Um die Formel festzulegen, legen Sie die neue SliderValue Eigenschaft in der Komponente auf die Wert-Eigenschaft des Schiebereglers fest.

1. Klicken Sie im Eigenschaftsbereich der Komponente auf die Slider Value-Eigenschaft.
2. Ersetzen Sie in der Bearbeitungsleiste den Standardwert 100 durch die folgenden Formel: Slider1.Value.

Jetzt spiegelt die Eigenschaft der Komponente SliderValue den Wert des Schiebereglers innerhalb der Komponente wider, den die nutzende App lesen kann.

Funktionseigenschaft

Eine Funktionseigenschaft enthält einen Ausdruck, der einen Wert zurückgibt. In der Regel akzeptiert die Funktion Argumente, die sie zur Berechnung des zurückzugebenden Werts verwendet.

Eine Output-Funktion ist eine einfache Möglichkeit, eine benutzerdefinierte Funktion für Power Apps zu erstellen. Die Komponente definiert eine Output-Funktion mit einem Ausdruck, der einige Argumente akzeptiert und einen Wert zurückgibt. Diese Funktion kann dann in einer App unter Verwendung des Namens der Komponente (z. B Component1) per Aufruf Component1.MyFunction(arg1, arg2) verwendet werden.

Eine Input-Funktion ermöglicht es einer nutzenden App, einer Komponente Logik bereitzustellen, ähnlich einem Funktionszeiger oder einer Rückruffunktion. Wenn die Komponente beispielsweise mit den Namen von Personen arbeitet, kann sie eine Eingabefunktion mit Argumenten firstname haben und lastname erwartet eine Zeichenfolge zurück. Die App kann den Funktionsausdruck definieren, um $"{firstname} {lastname}" oder $"{lastname}, {firstname}" zurückzugeben. Die Komponente ruft die vom App-Ersteller bereitgestellte Funktion auf und verwendet die zurückgegebene Zeichenfolge.

Aktionseigenschaft

Aktionseigenschaften ähneln Funktionseigenschaften vom Typ Ausgabe, aber sie erlauben Nebeneffektformeln und die Verkettung von Ausdrücken. Eine Komponente kann über eine Aktionseigenschaft AddRecord verfügen, mit der die App einen Datensatz zu einer Sammlung innerhalb der Komponente hinzufügen kann, oder über eine Reset Aktion, mit der Variablen oder Sammlungen innerhalb der Komponente gelöscht werden.

Im vorherigen Beispiel des Schiebereglers für die Daten-Eigenschaft können Sie eine Aktionseigenschaft namens ResetValue hinzufügen, um den Schieberegler auf seinen Standardwert zurückzusetzen. Verwenden Sie andernfalls die Formel Reset( Slider1 ) dafür. Jetzt können Instanzen der Komponente in der App Component1.ResetValue() aufrufen, um den Schieberegler auf den Standardwert zurückzusetzen.

Ereigniseigenschaft

Viele Standardsteuerelemente verfügen über allgemeine Ereignis-Typ-Eigenschaften, bei denen es sich um Funktionseigenschaften für das Eingabeverhalten handelt. OnSelect für das Schaltflächen-Steuerelement ist ein gängiges Beispiel. Eine Komponente kann Ereigniseigenschaften definieren und diese Ereignisse wie eine Funktion aufrufen. Beispielsweise kann eine Komponente mit einem Schaltflächen-Steuerelement eine Ereigniseigenschaft OnButtonClicked haben. Im OnSelect des Schaltflächensteuerelements kann die Komponente seine Component1.OnButtonClicked()-Eigenschaft aufrufen. Eine nutzende App kann ihre eigene Logik definieren, damit diese Eigenschaft agiert, wenn die Schaltfläche innerhalb der Komponente gedrückt wird.

Standardwerte für Eigenschaften oder Argumente

Standardwerte geben einem Argument oder einer Eigenschaft einen Wert, wenn keiner festgelegt ist. Dies ist für einige Arten von Eigenschaften nicht sinnvoll. In einigen Fällen können Sie Standardwerte verwenden, um das erwartete Schema für einen Datensatz anzuzeigen. Durch Bereitstellen eines Standarddatensatzes legen Sie den Datensatztyp als erwartetes Schema fest.

Eine Aktion-Eigenschaft mit dem Namen AddRecord nimmt z. B. einen Datensatz an, der einer lokalen Sammlung hinzugefügt werden soll. Um das Schema des erwarteten Datensatzes anzuzeigen, fügen Sie einen Standardwert für das Argument der AddRecord Eigenschaft hinzu.