Kartensteuerelement in Power Apps

Stellt die Anzeige- und Bearbeitungsoberfläche für ein einzelnes Feld eines Anzeigeformulars oder eines Bearbeitungsformular-Steuerelements bereit.

Description

Anzeigeformular - und Bearbeitungsformularsteuerelemente dienen als Container zum Anzeigen und Anzeigen ganzer Datensätze. Jeder Container kann eine Reihe von Kartensteuerelementen enthalten, die einzelne Felder anzeigen oder eine Möglichkeit zum Aktualisieren dieser Felder bieten. Jede Karte verfügt über eine DataField-Eigenschaft , die angibt, für welches Feld des Datensatzes es funktioniert.

Vordefinierte Karten werden für verschiedene Datentypen und Benutzeroberflächen definiert. Beispielsweise kann es eine Karte geben, um ein Zahlenfeld mit einem Texteingabesteuerelement zu bearbeiten, das ideal für die Verwendung mit der Tastatur ist. Eine andere Karte kann stattdessen das Bearbeiten einer Zahl mithilfe eines Schieberegler-Steuerelements unterstützen. Wenn das Formularsteuerelement ausgewählt ist, können Sie im rechten Bereich ganz einfach eine Karte basierend auf einem Feld auswählen.

Karten selbst enthalten Steuerelemente. Die Steuerelemente einer Karte bilden die Oberfläche zum Anzeigen und Bearbeiten eines einzelnen Felds. Beispielsweise kann eine Nummernkarte aus einem Bezeichnungssteuerelement bestehen, um den Anzeigenamen des Felds und ein Texteingabesteuerelement anzugeben, um einen Editor für den Wert des Felds bereitzustellen. Die Karte verfügt möglicherweise auch über ein Bezeichnungssteuerelement , das alle auftretenden Überprüfungsfehler anzeigt, und ein Bezeichnungssteuerelement für das allgemeine Sternchen, um anzugeben, dass ein Feld erforderlich ist.

Sie können die Steuerelemente einer vordefinierten Karte anpassen, indem Sie die Größe ändern, sie verschieben, ausblenden, steuerelemente hinzufügen und andere Änderungen vornehmen. Sie können auch mit einer völlig leeren Karte beginnen, einer "benutzerdefinierten Karte", zu der Sie Steuerelemente von Grund auf neu hinzufügen.

Vordefinierte Karten sind standardmäßig gesperrt . In einer gesperrten Karte können Sie nur bestimmte Eigenschaften der Karte oder der Steuerelemente innerhalb der Karte ändern, und Sie können keine gesperrte Karte löschen. Sie können die Kartensperre anzeigen und auf der Registerkarte "Ansicht " der Erweiterten Ansicht entsperren. Wenn eine Eigenschaft gesperrt ist und nicht geändert werden kann, wird sie mit einem Sperrsymbol neben dem Namen angezeigt. Das Entsperren einer Karte ist eine erweiterte Aktivität und sollte sorgfältig ausgeführt werden, da die automatische Formelgenerierung für die Karte nicht mehr auftritt und Sie eine Karte nicht erneut sperren können.

Innerhalb des Formularcontainers ist der ThisItem-Datensatz verfügbar und enthält alle Felder des Datensatzes. Die Standardeigenschaft der Karte wird z. B. häufig auf ThisItem festgelegt. FieldName.

Sie können den übergeordneten Verweis verwenden, um ein Steuerelement zu konfigurieren, um auf die Eigenschaften einer Karte zu verweisen. Ein Steuerelement sollte beispielsweise "Parent.Default " verwenden, um den Anfangszustand des Felds aus der Datenquelle zu lesen. Wenn Sie "Parent " anstelle des direkten Zugriffs auf die gewünschten Informationen verwenden, ist die Karte besser gekapselt, und Sie können sie in ein anderes Feld ändern, ohne interne Formeln zu unterbrechen.

Beispiele zum Anpassen, Entsperren und Erstellen von Karten finden Sie unter "Grundlegendes zu Datenkarten ".

Schlüsseleigenschaften

DataField – Der Name des Felds innerhalb eines Datensatzes, den diese Karte anzeigt und bearbeitet.

• Geben Sie den Namen als einzelne statische Zeichenfolge an, die in doppelte Anführungszeichen eingeschlossen ist (z. B. "Name"), keine Formel.
• Heben Sie die Verknüpfung einer Karte auf, indem Sie die DataField-Eigenschaftleer festlegen. Die Eigenschaften "Valid" und "Update" werden für ungebundene Karten ignoriert.

Standard – Der Anfangswert eines Steuerelements, bevor es vom Benutzer geändert wird.

• Legen Sie für jedes Steuerelement auf einer Karte diese Eigenschaft auf "Parent.Default " fest, um auf den Standardwert des Felds gemäß der Datenquelle zu verweisen. Legen Sie beispielsweise die Standardeigenschaft eines Schiebereglers auf "Parent.Default " fest, um sicherzustellen, dass der Benutzer mit einem generischen Wert für diesen Schieberegler beginnt.

DisplayMode – Werte können "Bearbeiten", "Anzeigen " oder "Deaktiviert" sein. Konfiguriert, ob das Steuerelement auf der Karte Benutzereingaben (Bearbeiten) zulässt, nur Daten (Ansicht) anzeigt oder deaktiviert ist (deaktiviert).

• Ermöglicht die Verwendung einer einzelnen Karte in Bearbeitungs- und Ansichtsformularen, indem diese Eigenschaft konfiguriert wird, die standardmäßig an das Verhalten des Formulars gebunden ist.
• Im Ansichtsmodus werden untergeordnete Steuerelemente wie Texteingabe, Dropdown,Datumsauswahl nur den Textwert angezeigt und keine interaktiven Elemente oder Dekorationen gerendert.

DisplayName – Der benutzerfreundliche Name für ein Feld in einer Datenquelle.

• Die DataSourceInfo-Funktion stellt diese Metadaten aus der Datenquelle bereit.
• Steuerelemente innerhalb der Karte sollten parent.DisplayName verwenden, um auf den Namen des Felds zu verweisen.

Fehler – Die benutzerfreundliche Fehlermeldung, die für dieses Feld angezeigt werden soll, wenn die Überprüfung fehlschlägt.

• Diese Eigenschaft wird festgelegt, wenn SubmitForm aufgerufen wird.
• In der Meldung werden Überprüfungsprobleme basierend auf den Metadaten der Datenquelle und die Überprüfung der erforderlichen Eigenschaft der Karte beschrieben.

Erforderlich – Ob eine Karte, die das Feld einer Datenquelle bearbeitet, einen Wert enthalten muss.

• Die DataSourceInfo-Funktion stellt die erforderlichen Metadaten aus der Datenquelle bereit.
• Steuerelemente innerhalb der Karte sollten parent.Required verwenden, um zu bestimmen, ob das Feld dieser Karte erforderlich ist.

Aktualisieren – Der Wert, der in die Datenquelle für ein Feld zurückgeschrieben werden soll.

• Verwenden Sie die Formel dieser Eigenschaft, um die Werte aus den Bearbeitungssteuerelementen der Karte abzurufen, um zurück in die Datenquelle zu schreiben. Legen Sie beispielsweise die Update-Eigenschaft einer Karte auf Slider.Value fest, um die Datenquelle mit einem Wert vom Schieberegler auf dieser Karte zu aktualisieren.

Width – Der Abstand zwischen den linken und rechten Rändern eines Steuerelements.

WidthFit – Gibt an, ob ein Steuerelement automatisch horizontal vergrößert wird, um leerer Platz in einem Containersteuerelement wie z. B. einem Bearbeitungsformular-Steuerelement auszufüllen. Wenn diese Eigenschaft auf "true" festgelegt ist, wird der Abstand zwischen den Karten aufgeteilt. Weitere Informationen finden Sie unter Grundlegendes zum Datenformularlayout.

Zusätzliche Eigenschaften

BorderColor – Die Farbe des Rahmens eines Steuerelements.

BorderStyle – Gibt an, ob der Rahmen eines Steuerelements einfarbig, gestrichelt, gepunktet oder None ist.

BorderThickness – Die Stärke des Rahmens eines Steuerelements.

Füllung – Die Hintergrundfarbe eines Steuerelements.

Höhe – Der Abstand zwischen den oberen und unteren Rändern eines Steuerelements.

Gültig – Ob ein Karten - oder Bearbeitungsformularsteuerelement gültige Einträge enthält, die an die Datenquelle übermittelt werden können.

Sichtbar – Ob ein Steuerelement angezeigt oder ausgeblendet ist.

X – Der Abstand zwischen dem linken Rand eines Steuerelements und dem linken Rand des übergeordneten Containers (vom Bildschirm, wenn kein übergeordneter Container vorhanden ist). Bei einem Kartensteuerelement in einem Container mit mehreren Spalten bestimmt diese Eigenschaft die Spalte, in der die Karte angezeigt wird.

Y – Der Abstand zwischen dem oberen Rand eines Steuerelements und dem oberen Rand des übergeordneten Containers (Vom Bildschirm, wenn kein übergeordneter Container vorhanden ist). Bei einem Kartensteuerelement in einem Container mit mehreren Zeilen bestimmt diese Eigenschaft die Zeile, in der die Karte angezeigt wird.

Examples

Beispiele finden Sie unter "Grundlegendes zu Datenkarten und Grundlegendes zum Datenformularlayout ".

Richtlinien für Eingabehilfen

Farbkontrast

Es muss ein ausreichender Farbkontrast zwischen:

• Ausfüllen und alle untergeordneten Steuerelemente. Wenn beispielsweise eine Karte ein Etikett enthält und das Etikett eine transparente Füllung aufweist, wird die Füllung der Karte effektiv zur Hintergrundfarbe für das Etikett. Daher sollte ein ausreichender Kontrast zwischen der Füllung der Karte und der Farbe des Etiketts bestehen.

Unterstützung für Sprachausgabe

• DisplayName muss vorhanden sein.