> 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
Schaltflächen ermöglichen Benutzern, mit einem einzigen Tippen Aktionen auszuführen und Auswahlen zu treffen.
## Ausgefüllte Schaltfläche
Ausgefüllte Schaltflächen haben eine hohe Betonung und zeichnen sich durch die Verwendung von Erhöhung und Füllung aus. 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 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 mit dem Parameter Style steuern
```powershell
New-UDButton -Id "Submit" -Text "Submit" -Style @{ Width = "150px"; Height = "100px" }
```
## Schaltflächen mit Symbolen und Bezeichnung
Manchmal möchten Sie für bestimmte Schaltflächen Symbole verwenden, um die UX der Anwendung zu verbessern, da wir Logos leichter erkennen als reinen Text. Wenn Sie zum Beispiel 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 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 Veranstaltungen 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ächengruppe
## Schaltfläche nach Klick 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=&goal=
```
`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.