Schaltflächen-Steuerelement in PowerAppsButton control in PowerApps

Ein Steuerelement, mit dem Benutzer durch Klicken oder Tippen mit der App interagieren können.A control that the user can click or tap to interact with the app.

BeschreibungDescription

Konfigurieren Sie die OnSelect-Eigenschaft eines Schaltflächen-Steuerelements, um eine oder mehrere Formeln auszuführen, wenn der Benutzer auf das Steuerelement klickt oder tippt.Configure the OnSelect property of a Button control to run one or more formulas when the user clicks or taps the control.

HaupteigenschaftenKey properties

OnSelect – Legt fest, wie die App reagiert, wenn der Benutzer auf ein Steuerelement tippt oder klickt.OnSelect – How the app responds when the user taps or clicks a control.

Text – Text, der in einem Steuerelement angezeigt wird oder von einem Benutzer in ein Steuerelement eingegeben wird.Text – Text that appears on a control or that the user types into a control.

Zusätzliche EigenschaftenAdditional properties

Align – Die Position von Text in Relation zur horizontalen Mitte des Steuerelements.Align – The location of text in relation to the horizontal center of its control.

AutoDisableOnSelect – Deaktiviert das Steuerelement automatisch, solange das OnSelect-Verhalten erfolgt.AutoDisableOnSelect – Automatically disables the control while the OnSelect behavior is running.

BorderColor – Die Farbe des Rahmens eines Steuerelements.BorderColor – The color of a control's border.

BorderStyle – Legt fest, ob der Rahmen eines Steuerelements Solid (Durchgehend), Dashed (Gestrichelt), Dotted (Gepunktet) oder None (Keiner) ist.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – Die Stärke des Rahmens eines Steuerelements.BorderThickness – The thickness of a control's border.

FocusedBorderThickness – Die Linienstärke des Rahmen eines Steuerelements, wenn es den Tastaturfokus hat.FocusedBorderThickness – The thickness of a control's border when it has keyboard focus.

Color – Die Farbe des Texts in einem Steuerelement.Color – The color of text in a control.

DisplayMode: Legt fest, ob das Steuerelement Benutzereingaben zulässt (Edit, Bearbeiten), ob nur Daten angezeigt werden (View, Anzeigen) oder ob das Steuerelement deaktiviert ist (Disabled, Deaktiviert).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

DisabledBorderColor: Die Farbe des Steuerelementrahmens, wenn die DisplayMode-Eigenschaft des Steuerelements auf Disabled (Deaktiviert) festgelegt ist.DisabledBorderColor – The color of a control's border if the control's DisplayMode property is set to Disabled.

DisabledColor: Die Farbe des Texts in einem Steuerelement, wenn seine DisplayMode-Eigenschaft auf Disabled (Deaktiviert) festgelegt ist.DisabledColor – The color of text in a control if its DisplayMode property is set to Disabled.

DisabledFill: Die Hintergrundfarbe eines Steuerelements, wenn dessen DisplayMode-Eigenschaft auf Disabled (Deaktiviert) festgelegt ist.DisabledFill – The background color of a control if its DisplayMode property is set to Disabled.

Fill – Die Hintergrundfarbe eines Steuerelements.Fill – The background color of a control.

Font – Der Name der Schriftfamilie des angezeigten Texts.Font – The name of the family of fonts in which text appears.

FontWeight – Die Schriftbreite des Texts in einem Steuerelement: Bold (Fett), Semibold (Halbfett), Normal oder Lighter (Heller).FontWeight – The weight of the text in a control: Bold, Semibold, Normal, or Lighter.

Height – Die Entfernung zwischen dem oberen und unteren Rand eines Steuerelements.Height – The distance between a control's top and bottom edges.

HoverBorderColor – Die Rahmenfarbe eines Steuerelements, wenn der Benutzer den Mauszeiger über das Steuerelement hält.HoverBorderColor – The color of a control's border when the user keeps the mouse pointer on that control.

HoverColor – Die Farbe des Texts in einem Steuerelement, wenn der Benutzer den Mauszeiger über ihm hält.HoverColor – The color of the text in a control when the user keeps the mouse pointer on it.

HoverFill – Die Hintergrundfarbe eines Steuerelements, wenn der Benutzer den Mauszeiger über ihm hält.HoverFill – The background color of a control when the user keeps the mouse pointer on it.

Italic – Legt fest, ob der Text in einem Steuerelement kursiv formatiert ist.Italic – Whether the text in a control is italic.

PaddingBottom – Der Abstand zwischen dem Text in einem Steuerelement und dem unteren Rand des Steuerelements.PaddingBottom – The distance between text in a control and the bottom edge of that control.

PaddingLeft: Der Abstand zwischen dem Text eines Steuerelements und dem linken Rand des Steuerelements.PaddingLeft – The distance between text in a control and the left edge of that control.

PaddingRight: Der Abstand zwischen dem Text eines Steuerelements und dem rechten Rand des Steuerelements.PaddingRight – The distance between text in a control and the right edge of that control.

PaddingTop – Der Abstand zwischen dem Text in einem Steuerelement und dem oberen Rand des Steuerelements.PaddingTop – The distance between text in a control and the top edge of that control.

PressedTrue, wenn das Steuerelement gedrückt ist, andernfalls false.PressedTrue while a control is being pressed, false otherwise.

PressedBorderColor – Die Rahmenfarbe eines Steuerelements, wenn der Benutzer auf das Steuerelement tippt oder klickt.PressedBorderColor – The color of a control's border when the user taps or clicks that control.

PressedColor – Die Farbe des Texts in einem Steuerelement, wenn der Benutzer auf das Steuerelement tippt oder klickt.PressedColor – The color of text in a control when the user taps or clicks that control.

PressedFill – Die Hintergrundfarbe eines Steuerelements, wenn der Benutzer auf das Steuerelement tippt oder klickt.PressedFill – The background color of a control when the user taps or clicks that control.

RadiusBottomLeft – Der Grad der Rundung der linken unteren Ecke eines Steuerelements.RadiusBottomLeft – The degree to which the bottom-left corner of a control is rounded.

RadiusBottomRight – Der Grad der Rundung der rechten unteren Ecke eines Steuerelements.RadiusBottomRight – The degree to which the bottom-right corner of a control is rounded.

RadiusTopLeft – Der Grad der Rundung der linken oberen Ecke eines Steuerelements.RadiusTopLeft – The degree to which the top-left corner of a control is rounded.

RadiusTopRight – Der Grad der Rundung der rechten oberen Ecke eines Steuerelements.RadiusTopRight – The degree to which the top-right corner of a control is rounded.

Size – Der Schriftgrad des Texts, der in einem Steuerelement angezeigt wird.Size – The font size of the text that appears on a control.

Strikethrough – Legt fest, ob der in einem Steuerelement angezeigte Text durchgestrichen ist.Strikethrough – Whether a line appears through the text that appears on a control.

TabIndex: Passt die Aktivierreihenfolge von Steuerelementen zur Laufzeit an, wenn sie auf einen Wert ungleich 0 festgelegt wird.TabIndex – Customizes the tab order of controls at runtime when set to a non-zero value.

QuickInfo: Erklärender Text, der angezeigt wird, wenn der Benutzer auf ein Steuerelement zeigt.Tooltip – Explanatory text that appears when the user hovers over a control.

Underline – Legt fest, ob der in einem Steuerelement angezeigte Text unterstrichen ist.Underline – Whether a line appears under the text that appears on a control.

VerticalAlign – Die Position des Texts in einem Steuerelement in Relation zur vertikalen Mitte des Steuerelements.VerticalAlign – The location of text on a control in relation to the vertical center of that control.

Visible – Legt fest, ob ein Steuerelement angezeigt wird oder ausgeblendet ist.Visible – Whether a control appears or is hidden.

Width – Der Abstand zwischen dem linken und rechten Rand eines Steuerelements.Width – The distance between a control's left and right edges.

X – Der Abstand zwischen dem linken Rand eines Steuerelements und dem linken Rand des übergeordneten Containers (bzw. des Bildschirms, wenn kein übergeordneter Container vorhanden ist).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – Der Abstand zwischen dem oberen Rand eines Steuerelements und dem oberen Rand des übergeordneten Containers (bzw. des Bildschirms, wenn kein übergeordneter Container vorhanden ist).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

Navigate( ScreenName, ScreenTransitionValue )Navigate( ScreenName, ScreenTransitionValue )

BeispieleExamples

Hinzufügen einer einfachen Formel zu einer SchaltflächeAdd a basic formula to a button

  1. Fügen Sie ein Texteingabe-Steuerelement hinzu, und benennen Sie es Source.Add a Text input control, and name it Source.

    Möchten Sie wissen, wie Sie ein Steuerelement hinzufügen, benennen und konfigurieren?Don't know how to add, name, and configure a control?

  2. Fügen Sie ein Schaltflächen-Steuerelement hinzu, legen Sie dessen Text-Eigenschaft auf „Hinzufügen“ und dessen OnSelect-Eigenschaft auf diese Formel fest:Add a Button control, set its Text property to "Add", and set its OnSelect property to this formula:
    UpdateContext({Total:Total + Value(Source.Text)}) UpdateContext({Total:Total + Value(Source.Text)})

    Benötigen Sie weitere Informationen zur UpdateContext-Funktion oder zu anderen Funktionen?Want more information about the UpdateContext function or other functions?

  3. Fügen Sie ein Bezeichnung-Steuerelement hinzu, legen Sie dessen Text-Eigenschaft auf Summe fest, und drücken Sie dann F5.Add a Label control, set its Text property to Total, and then press F5.
  4. Löschen Sie den Standardtext aus Quelle, geben Sie eine Zahl ein, und klicken oder tippen Sie dann auf Hinzufügen.Clear the default text from Source, type a number in it, and then click or tap Add.

    Im Label-Steuerelement (Bezeichnung) wird die von Ihnen eingegebene Zahl angezeigt.The Label control shows the number that you typed.

  5. Löschen Sie die Zahl aus Quelle, geben Sie eine andere Zahl ein, und klicken oder tippen Sie dann auf Hinzufügen.Clear the number from Source, type another number in it, and then click or tap Add.

    Im Bezeichnung-Steuerelement wird die Summe der von Ihnen eingegebenen beiden Zahlen angezeigt.The Label control shows the sum of the two numbers that you typed.

  6. (Optional) Wiederholen Sie den vorherigen Schritt einmal oder mehrmals.(optional) Repeat the previous step one or more times.
  7. Um zum Standardarbeitsbereich zurückzukehren, drücken Sie die ESC-TASTE (oder klicken oder tippen rechts oben auf das Symbol X).To return to the default workspace, press Esc (or click or tap the close icon in the upper-right corner).

Konfigurieren einer Schaltfläche mit mehreren FormelnConfigure a button with multiple formulas

Fügen Sie eine Formel hinzu, die das Texteingabe-Steuerelement zwischen Einträgen löscht.Add a formula that clears the Text input control between entries.

  1. Legen Sie die HintText-Eigenschaft von Quelle auf „Eine Zahl eingeben“ fest.Set the HintText property of Source to "Enter a number".
  2. Legen Sie die OnSelect-Eigenschaft von Hinzufügen auf die folgende Formel fest:Set the OnSelect property of Add to this formula:

    UpdateContext({Total:Total + Value(Source.Text)});
    UpdateContext({ClearInput: ""})
    UpdateContext({Total:Total + Value(Source.Text)});
    UpdateContext({ClearInput: ""})

    Hinweis: Trennen Sie mehrere Formeln durch ein Semikolon ;.Note: Separate multiple formulas with a semi-colon “;”.

  3. Legen Sie die Default-Eigenschaft von Quelle auf ClearInput fest.Set the Default property of Source to ClearInput.
  4. Drücken Sie F5, und testen Sie dann die App, indem Sie mehrere Werte addieren.Press F5, and then test the app by adding several numbers together.

Hinzufügen einer weiteren Schaltfläche zum Zurücksetzen der SummeAdd another button to reset the total

Fügen Sie eine zweite Schaltfläche hinzu, um die Summe zwischen Berechnungen zu löschen.Add a second button to clear the total between calculations.

  1. Fügen Sie ein weiteres Schaltflächen-Steuerelement hinzu, legen Sie dessen Text-Eigenschaft auf „Löschen“ und dessen OnSelect-Eigenschaft auf diese Formel fest:Add another Button control, set its Text property to "Clear", and set its OnSelect property to this formula:

    UpdateContext({Total:0})UpdateContext({Total:0})

  2. Drücken Sie F5, addieren Sie mehrere Zahlen, und klicken oder tippen Sie dann auf Löschen, um die Summe zurückzusetzen.Press F5, add several numbers together, and then click or tap Clear to reset the total.

Ändern der Darstellung einer SchaltflächeChange a button's appearance

Ändern der Form einer SchaltflächeChange a button's shape

PowerApps erstellt standardmäßig ein rechteckiges Schaltflächen-Steuerelement mit abgerundeten Ecken.By default, PowerApps creates a rectangular Button control with rounded corners. Sie können einfache Änderungen an der Form eines Schaltflächen-Steuerelements vornehmen, indem Sie dessen Eigenschaften Height, Width und Radius festlegen.You can make basic modifications to the shape of a Button control by setting its Height, Width, and Radius properties.

Hinweis: Symbole und Formen bieten eine Vielzahl von Designs und können einige derselben Grundfunktionen wie Schaltflächen-Steuerelemente ausführen.Note: Icons and Shapes provide a wide variety of designs and can perform some of the same basic functions that Button controls do. Allerdings haben Symbole und Formen keine Text-Eigenschaft.However, Icons and Shapes don’t have a Text property.

  1. Fügen Sie ein Schaltflächen-Steuerelement hinzu, und legen Sie die Eigenschaften Height und Width auf 300 fest, um eine große quadratische Schaltfläche zu erstellen.Add a Button control, and set its Height and Width properties to 300 to make a large square button.
  2. Ändern Sie die Eigenschaften RadiusTopLeft, RadiusTopRight, RadiusBottomLeft und RadiusBottomRight, um den Grad der Krümmung jeder Ecke anzupassen.Modify the RadiusTopLeft, RadiusTopRight, RadiusBottomLeft, and RadiusBottomRight properties to adjust the amount of curvature on each corner. Es folgen einige Beispiele verschiedener Formen, die alle von einer quadratischen Schaltfläche mit den Maßen 300 x 300 ausgehen:Here are some examples of different shapes, each one starting from a 300 x 300 square button:

Ändern der Farbe einer Schaltfläche, wenn darauf gezeigt wirdChange a button's color when you hover over it

Standardmäßig wird die Füllfarbe eines Schaltflächen-Steuerelements um 20 % abgeblendet, wenn Sie mit der Maus darauf zeigen.By default, the fill color of a Button control will dim by 20% when you hover over it with a mouse. Sie können dieses Verhalten anpassen, indem Sie die HoverFill-Eigenschaft ändern, die die ColorFade-Funktion nutzt.You can adjust this behavior by changing the HoverFill property, which uses the ColorFade function. Wenn Sie die ColorFade-Formel auf einen positiven Prozentsatz festlegen, wird die Schaltfläche heller, sobald Sie darauf zeigen, während sie bei einem negativen Prozentsatz dunkler wird.If you set the ColorFade formula to a positive percentage, the color becomes lighter when you hover over the button, while a negative percentage makes the color darker.

  • Ändern Sie den ColorFade-Prozentsatz der HoverFill-Eigenschaft einer der Schaltflächen, die Sie erstellt haben, und beobachten Sie die Auswirkungen.Change the ColorFade percentage in the HoverFill property of one of the buttons that you created, and observe the effects.

Sie können die Farbe eines Schaltflächen-Steuerelements auch durch Festlegen seiner HoverFill-Eigenschaft auf eine Formel angeben, die die ColorValue-Funktion anstelle der ColorFade-Funktion enthält, wie z. B. in ColorValue("Red").You can also specify the color of a Button control by setting its HoverFill property to a formula that contains the ColorValue function instead of the ColorFade function, as in ColorValue("Red").

Hinweis: Der Farbwert kann eine beliebige CSS-Farbdefinition sein: entweder ein Name oder ein hexadezimaler Wert.Note: The color value can be any CSS color definition, either a name or a hex value.

  • Ersetzen Sie auf einer der Schaltflächen, die Sie erstellt haben, die ColorFade-Funktion durch eine ColorValue-Funktion, und beobachten die Auswirkungen.Replace the ColorFade function with a ColorValue function in one of the buttons that you created, and observe the effects.