> 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/textbox.md).

# Textbox

Eine Textbox ermöglicht Benutzern die Eingabe und Bearbeitung von Text.

## Textbox

![](/files/Ci6d6tROLl4x1HtspZJz)

```powershell
New-UDTextbox -Label 'Standard' -Placeholder 'Textbox'
New-UDTextbox -Label 'Disabled' -Placeholder 'Textbox' -Disabled
New-UDTextbox -Label 'Textbox' -Value 'With value'
```

## Textbox-Typen

Textboxen können umgestellt werden, um bestimmte Typen zu akzeptieren, wie Passwörter, Zahlen oder E-Mails.

### Passwort-Typ

Eine Passwort-Textbox maskiert die Eingabe.

![](/files/o6lCFF4lAIl0OaXMpYiW)

```powershell
New-UDTextbox -Label 'Password' -Type password
```

### Zahlen-Typ

Akzeptiert nur Zahlen. Einige Browser zeigen Pfeile nach oben und unten an, um den aktuellen Wert zu erhöhen und zu verringern.

![](/files/68ItqQ9wRlschiV1VO5M)

```powershell
New-UDTextbox -Label 'Number' -Type number -Minimum 10 -Maximum 10000 -Value 1234
```

## Mehrzeilig

Sie können eine mehrzeilige Textbox mit dem Parameter `-Multiline` erstellen. Durch Drücken der Eingabetaste wird eine neue Zeile hinzugefügt. Sie können die Anzahl der Zeilen und die maximale Anzahl der Zeilen mit `-Rows` und `-RowsMax` festlegen.

```powershell
New-UDTextbox -Multiline -Rows 4 -RowsMax 10
```

## Interaktion

### Abrufen eines Textbox-Werts

Sie können `Get-UDElement` verwenden, um den Wert einer Textbox abzurufen

```powershell
New-UDTextbox -Id 'txtExample' 
New-UDButton -OnClick {
    $Value = (Get-UDElement -Id 'txtExample').value 
    Show-UDToast -Message $Value
} -Text "Get textbox value"
```

### Festlegen des Textbox-Werts

```powershell
New-UDTextbox -Id 'txtExample' -Label 'Label' -Value 'Value'

New-UDButton -OnClick {

    Set-UDElement -Id 'txtExample' -Properties @{
        Value = "test123"
    }

} -Text "Get textbox value"
```

## Symbole

Sie können das Symbol einer Textbox mit dem Parameter `-Icon` und dem Cmdlet `New-UDIcon` festlegen.

```powershell
New-UDTextbox -Id "ServerGroups" -Icon (New-UDIcon -Icon 'server') -Value "This is my server"
```

![](/files/puhIC5P9XRDvT4geFxGV)

## Maskierung

Sie können `-MaskPattern` verwenden, um eine Maske für die Textbox zu definieren. Im Folgenden finden Sie ein Beispiel für eine Textbox-Maske.

```powershell
New-UDTextbox -Id 'textbox16' -MaskPattern '+7 (000) 000-00-00'
```

Die Definition kann Folgendes enthalten

* `0` - eine beliebige Ziffer
* `a` - ein beliebiger Buchstabe
* `*` - ein beliebiges Zeichen
* andere Zeichen, die nicht in benutzerdefinierten Definitionen enthalten sind, gelten als *fixed*
* `[]` - Eingabe optional machen
* `{}` - festen Teil im unmaskierten Wert einschließen
* `` ` `` - Zurückverschieben von Symbolen verhindern

Wenn ein Definitionszeichen als fest behandelt werden soll, muss es mit `\\` escaped werden (z. B. `\\0`).

Die Maskierung für die Textbox wird durch [imaskjs](https://imask.js.org/guide.html#masked-pattern) gesteuert.

## OnEnter

Der Event-Handler `-OnEnter` wird ausgeführt, wenn der Benutzer im Textfeld die Eingabetaste drückt. Er ist nützlich, um beim Drücken der Eingabetaste andere Aktionen auszuführen, z. B. das Klicken auf eine Schaltfläche.

```powershell
New-UDTextbox -OnEnter {
    Invoke-UDEndpoint -Id 'submit' -Session
}

New-UDButton -Id 'submit' -OnClick {
    Show-UDToast -Message 'From Textbox'
}
```

## OnBlur

Der Event-Handler `-OnBlur` wird ausgeführt, wenn die Textbox den Fokus verliert.

```powershell
New-UDTextbox -OnBlur {
    Show-UDToast "Blurred"
}
```

## OnValidate

Verwenden Sie den Event-Handler `-OnValidate`, um die in der Textbox eingegebene Eingabe zu validieren.

```powershell
New-UDTextbox -OnValidate {
    if ($EventData.Length -lt 10)
    {
        New-UDValidationResult -ValidationError 'String needs to be longer than 10'
    }
}
```

## API

[New-UDTextbox](/powershell-universal/de/powershell-befehle/new-udtextbox.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/textbox.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.