> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/de/apps/components/inputs/button.md).

# Button

Fügen Sie in PowerShell Universal-Apps gefüllte, umrandete, Symbol- und Lade-Schaltflächen hinzu, einschließlich Schaltflächengruppen und Klick-Event-Handlern für Benutzeraktionen.

Schaltflächen ermöglichen es Benutzern, mit einem einzigen Tippen Aktionen auszuführen und Entscheidungen zu treffen.

## Gefüllte Schaltfläche

Gefüllte Schaltflächen sind Schaltflächen mit hoher Betonung, die sich durch ihre Verwendung von Erhöhung und Füllung auszeichnen. Sie enthalten Aktionen, die für Ihre App primär sind.

```powershell
 New-UDButton -Variant 'contained' -Text 'Default'
```

## Umrandete Schaltfläche

Umrandete Schaltflächen sind Schaltflächen mit mittlerer Betonung. Sie enthalten Aktionen, die wichtig sind, aber nicht die primäre Aktion in einer App darstellen.

```powershell
New-UDButton -Variant 'outlined' -Text 'Default'
```

## Schaltflächengröße steuern

Sie können die Pixelgröße einer Schaltfläche anhand der Pixelgröße mithilfe des Parameters Style steuern

```powershell
New-UDButton -Id "Submit" -Text "Submit" -Style @{ Width = "150px"; Height = "100px" }
```

## Schaltflächen mit Symbolen und Beschriftung

Manchmal möchten Sie vielleicht Symbole für bestimmte Schaltflächen verwenden, um die UX der Anwendung zu verbessern, da wir Logos leichter erkennen als reinen Text. Wenn Sie beispielsweise eine Löschen-Schaltfläche haben, können Sie sie mit einem Mülleimer-Symbol kennzeichnen.

```powershell
New-UDButton -Icon (New-UDIcon -Icon trash) -Text 'Delete'
```

## Schaltflächen mit Event-Handlern

Sie können einen Skriptblock angeben, der ausgeführt wird, wenn auf die Schaltfläche geklickt wird

```powershell
New-UDButton -Text 'Message Box' -OnClick {
    Show-UDToast -Message 'Hello, world!'
}
```

## Lade-Schaltfläche

Lade-Schaltflächen zeigen ein Ladesymbol an, während ein Event-Handler ausgeführt wird. Dies ist bei länger laufenden Ereignissen nützlich.

```powershell
New-UDButton -Text 'Message Box' -OnClick {
    Show-UDToast -Message 'Hello, world!'
    Start-Sleep 10
} -ShowLoading
```

## Schaltflächengruppe

Eine Schaltflächengruppe erzeugt eine Schaltfläche mit einem Dropdown-Menü. Diese wird auch als geteilte Schaltfläche bezeichnet.

```powershell
New-UDButtonGroup -Children {
    New-UDButtonGroupItem -Text "Button 1" -OnClick {
        Show-UDToast "Button 1"
    }
    New-UDButtonGroupItem -Text "Button 2" -OnClick {
        Show-UDToast "Button 2"
    }
    New-UDButtonGroupItem -Text "Button 3" -OnClick {
        Show-UDToast "Button 3"
    }
}
```

## Schaltfläche nach dem Klicken deaktivieren

Dieses Beispiel verwendet `Set-UDElement`, um die Schaltfläche nach dem Ausführen einer Aktion zu deaktivieren.

```powershell
New-UDButton -Id "btn1" -OnClick {
    Show-UDToast "Hello!"
    Set-UDElement -Id 'btn1' -Attributes @{
        disabled = $true
    }
}
```

## API

* [New-UDButton](/powershell-universal/de/powershell-befehle/new-udbutton.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/powershell-universal/de/apps/components/inputs/button.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.