Umschalter-Steuerelement in Power Apps

Artikel
03/16/2023

Ein Steuerelement, das die Benutzer durch Verschieben des Handles aktivieren oder deaktivieren können.

Beschreibung

Umschalten wurde für aktuelle GUIs entwickelt, verhält sich jedoch genauso wie ein Kontrollkästchen.

Wichtige Eigenschaften

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

Value - Gibt den Wert eines Eingabesteuerelements an.

Zusätzliche Eigenschaften

AccessibleLabel - Bezeichnung für Sprachausgaben.

BorderColor - Die Farbe des Rahmens eines Steuerelements.

BorderStyle - Legt fest, ob der Rahmen eines Steuerelements Durgehend, Gestrichelt, Gepunktet oder Keine ist.

BorderThickness - Die Linienstärke des Rahmens eines Steuerelements.

DisplayMode - Legt fest, ob das Steuerelement Benutzereingaben zulässt (Bearbeiten), ob nur Daten angezeigt werden (Anzeigen) oder ob das Steuerelement deaktiviert ist (Deaktiviert).

DisabledBorderColor: Die Farbe des Steuerelementrahmens, wenn die DisplayMode-Eigenschaft des Steuerelements auf Deaktiviert festgelegt ist.

FalseFill - Die Füllfarbe der Umschaltfläche, wenn sie deaktiviert ist.

FalseHoverFill - Die Hoverfüllfarbe der Umschaltfläche, wenn sie deaktiviert ist.

FalseText – Der Text, der angezeigt wird, wenn die Umschaltfläche deaktiviert ist.

Fill - Die Hintergrundfarbe eines Steuerelements.

FocusedBorderColor - Die Rahmenfarbe eines Steuerelements, wenn das Steuerelement der Fokus ist.

FocusedBorderThickness - Die Rahmendicke eines Steuerelements, wenn das Steuerelement der Fokus ist.

HandleFill - die Füllfarbe des Handles „Schalter“.

Height - Die Entfernung zwischen dem oberen und unteren Rand eines Steuerelements.

HoverBorderColor – Die Rahmenfarbe eines Steuerelements, wenn der Benutzer den Mauszeiger über das Steuerelement hält.

OnChange – Auszuführende Aktionen, wenn der Benutzer den Wert eines Steuerelements ändert (z. B. per Schieberegler).

OnCheck – Auszuführende Aktionen, wenn sich der Wert eines Kontrollkästchens oder von Umschalten auf TRUE ändert.

OnSelect – Auszuführende Aktionen, wenn der Benutzer auf ein Steuerelement tippt oder klickt.

OnUncheck – Auszuführende Aktionen, wenn sich der Wert eines Kontrollkästchens oder von Umschalten auf FALSE ändert.

PressedBorderColor – Die Rahmenfarbe eines Steuerelements, wenn der Benutzer auf das Steuerelement tippt oder klickt.

RailFill – Die Farbe des Hintergrunds des Rechtecks im Umschalten-Steuerelement, wenn sein Wert false ist, oder die Farbe der Linie auf der rechten Seite des Handles in einem Schiebereglersteuerelement.

RailHoverFill – Wenn Sie auf das Umschalten-Steuerelement oder den Schieberegler zeigen: Die Farbe des Hintergrunds des Rechtecks im Umschalten-Steuerelement, wenn sein Wert false ist, oder die Farbe der Linie auf der rechten Seite des Handles in einem Schiebereglersteuerelement.

Reset – Gibt an, ob ein Steuerelement auf seinen Standardwert zurückgesetzt wird.

ShowLabel - Gibt an, ob neben dem Umschalt-Steuerelement eine Textbezeichnung angezeigt werden soll.

TabIndex: Navigationsreihenfolge der Tastatur in Bezug auf andere Steuerelemente.

TextPosition - Gibt an, ob sich die Bezeichnung links oder rechts neben dem Umschalt-Steuerelement befindet.

Tooltip - Erklärender Text, der angezeigt wird, wenn der Benutzer auf ein Steuerelement zeigt.

TrueFill - Die Füllfarbe der Umschaltfläche, wenn sie aktiviert ist.

TrueHoverFill - Die Hoverfüllfarbe der Umschaltfläche, wenn sie aktiviert ist.

TrueText - Der Text, der angezeigt wird, wenn die Umschaltfläche aktiviert ist.

ValueFill –– Die Farbe des Hintergrunds des Rechtecks im Umschalten-Steuerelement, wenn sein Wert true ist, oder die Farbe der Linie auf der linken Seite des Handles in einem Schiebereglersteuerelement.

ValueHoverFill – Wenn Sie mit dem Mauszeiger auf das Umschalten-Steuerelement oder den Schieberegler zeigen: Die Farbe des Hintergrunds des Rechtecks im Umschalten-Steuerelement, wenn sein Wert true ist, oder die Farbe der Linie auf der linken Seite des Handles in einem Schiebereglersteuerelement.

Visible - Gibt an, ob ein Steuerelement angezeigt wird oder ausgeblendet ist.

Width - Der Abstand zwischen dem linken und rechten Rand eines Steuerelements.

X – Der Abstand zwischen dem linken Rand eines Steuerelements und dem linken Rand des übergeordneten Containers (vom Bildschirm, wenn kein übergeordneter Container vorhanden ist).

Y – Der Abstand zwischen dem oberen Rand eines Steuerelements und dem oberen Rand des übergeordneten Containers (Vom Bildschirm, wenn kein übergeordneter Container vorhanden ist).

Beispiel

Fügen Sie Umschalten hinzu, und nennen Sie es MemberDiscount.

Möchten Sie wissen, wie Sie ein Steuerelement hinzufügen, benennen und konfigurieren?
Fügen Sie eine Bezeichnung hinzu, und legen Sie deren Eigenschaft Text auf diese Funktion fest:
If(MemberDiscount.Value = true, "Preis: $75", "Preis: $100")

Benötigen Sie weitere Informationen zur If-Funktion oder anderen Funktionen?
Drücken Sie F5, und ändern Sie den Wert der MemberDiscount.

Die Bezeichnung zeigt einen anderen Preis, je nachdem, ob MemberDiscount aktiviert oder deaktiviert ist.
Drücken Sie ESC, um zum Standardarbeitsbereich zurückzukehren.

Richtlinien für Barrierefreiheit

Farbkontrast

Zwischen den folgenden Eigenschaften muss es einen ausreichenden Farbkontrast geben:

HandleFill und FalseFill
HandleFill und FalseHoverFill
HandleFill und TrueFill
HandleFill und TrueHoverFill
FalseFill und die Farbe außerhalb des Steuerelements
FalseHoverFill und die Farbe außerhalb des Steuerelements
TrueFill und die Farbe außerhalb des Steuerelements
TrueHoverFill und Farbe außerhalb des Steuerelements

Dies ist ein Zusatz zu den Standardanforderungen für Farbkontraste.

Screenreadersupport

AccessibleLabel muss vorhanden sein.
Die FalseText-Eigenschaft muss vorhanden sein.
Die TrueText-Eigenschaft muss vorhanden sein.

Unterstützung für Menschen mit Sehbehinderungen

Sie sollten ShowLabel auf TRUE festlegen, damit Benutzer den Wert des Schalters schnell festlegen können.

Tastaturunterstützung

TabIndex muss gleich Null oder größer sein, damit Tastaturbenutzer dorthin navigieren können.
Fokusindikatoren müssen deutlich sichtbar sein. FocusedBorderColor und FocusedBorderThickness können Ihnen dabei helfen.

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).