> 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

Fügen Sie PowerShell Universal-Apps Texteingabefelder mit Passwort-, Zahlen- und mehrzeiligen Typen, Maskierung, Symbolen und Validierungs-Event-Handlern hinzu.

Eine Textbox ermöglicht es Benutzern, Text einzugeben und zu bearbeiten.

## Textbox

{% code collapsedlinecount="10" %}

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

{% endcode %}

## Textbox-Typen

Textboxen können so umgestellt werden, dass sie bestimmte Typen akzeptieren, wie zum Beispiel Passwörter, Zahlen oder E-Mails.

### Passwort-Typ

Eine Passwort-Textbox maskiert die Eingabe.

{% code collapsedlinecount="10" %}

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

{% endcode %}

### Zahlen-Typ

Akzeptiert nur Zahlen. Einige Browser zeigen Aufwärts- und Abwärtspfeile an, um den aktuellen Wert zu erhöhen und zu verringern.

{% code collapsedlinecount="10" %}

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

{% endcode %}

## Mehrzeilig

Sie können mit dem Parameter `-Multiline` eine mehrzeilige Textbox 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.

{% code collapsedlinecount="10" %}

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

{% endcode %}

## Interaktion

### Abrufen eines Textbox-Werts

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

{% code collapsedlinecount="10" %}

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

{% endcode %}

### Festlegen des Textbox-Werts

{% code collapsedlinecount="10" %}

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

New-UDButton -OnClick {

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

} -Text "Get textbox value"
```

{% endcode %}

## Symbole

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

{% code collapsedlinecount="10" %}

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

{% endcode %}

## Maskierung

Sie können `-MaskPattern` verwenden, um eine Maske für die Textbox zu definieren. Das Folgende ist ein Beispiel für eine Textbox-Maske.

{% code collapsedlinecount="10" %}

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

{% endcode %}

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 *fest*
* `[]` - Eingabe optional machen
* `{}` - festen Teil in den unmaskierten Wert einbeziehen
* `` ` `` - 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 von [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 bei Drücken der Eingabetaste andere Aktionen auszuführen, wie zum Beispiel das Klicken auf eine Schaltfläche.

{% code collapsedlinecount="10" %}

```powershell
New-UDTextbox -OnEnter {
    Invoke-UDEvent -Id 'submit' -Event onClick
}

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

{% endcode %}

## OnBlur

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

{% code collapsedlinecount="10" %}

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

{% endcode %}

## OnValidate

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

{% code collapsedlinecount="10" %}

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

{% endcode %}

## 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.