> 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/powershell-befehle/new-udtextbox.md). # New-UDTextbox New-UDTextbox erstellt in PowerShell Universal ein Texteingabefeld zum Eingeben und Bearbeiten von Werten, das eigenständig oder innerhalb eines Formulars verwendet werden kann. ### Übersicht Textfelder ermöglichen Benutzern das Eingeben und Bearbeiten von Text. ### Syntax ```powershell New-UDTextbox [[-Id] ] [[-Label] ] [[-Placeholder] ] [[-Value] ] [[-Type] ] [-Disabled] [[-Icon] ] [-Autofocus] [-Multiline] [[-Rows] ] [[-RowsMax] ] [-FullWidth] [[-Variant] ] [[-ClassName] ] [[-OnEnter] ] [[-OnBlur] ] [-Shrink] [[-OnValidate] ] [[-HelperText] ] [[-OnChange] ] [[-Minimum] ] [[-Maximum] ] [[-MaximumLength] ] [[-Sx] ] [[-Style] ] [[-MaskPattern] ] [[-Attributes] ] [] ``` ### Beschreibung Erstellt ein Textfeld. Textfelder können eigenständig oder innerhalb eines New-UDForm verwendet werden. ### Parameter #### -Id Die ID der Komponente. Standardmäßig ist dies eine zufällige GUID. ``` Required? false Position? 1 Default value ([Guid]::NewGuid()) Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Label Eine Beschriftung, die über diesem Textfeld angezeigt wird. ``` Required? false Position? 2 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Placeholder Ein Platzhalter, der im Textfeld angezeigt wird. ``` Required? false Position? 3 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Value Der aktuelle Wert des Textfelds. ``` Required? false Position? 4 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Type Der Typ des Textfelds. Dies können Werte wie text, password oder email sein. ``` Required? false Position? 5 Default value text Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Disabled Ob dieses Textfeld deaktiviert ist. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Icon Das Symbol, das neben dem Textfeld angezeigt wird. Verwenden Sie New-UDIcon, um ein Symbol zu erstellen. ``` Required? false Position? 6 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Autofocus Ob dieses Textfeld automatisch fokussiert werden soll. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Multiline Erstellt ein mehrzeiliges Textfeld ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Rows Die Anzahl der Zeilen in einem mehrzeiligen Textfeld. ``` Required? false Position? 7 Default value -1 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -RowsMax Die maximale Anzahl der Zeilen in einem mehrzeiligen Textfeld. ``` Required? false Position? 8 Default value 9999 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -FullWidth Ob dieses Textfeld die gesamte Breite des übergeordneten Steuerelements einnehmen soll. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Variant Die Variante des Textfelds. Gültige Werte sind "filled", "outlined", "standard" ``` Required? false Position? 9 Default value standard Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -ClassName Eine CSS-Klasse, die auf das Textfeld angewendet wird. ``` Required? false Position? 10 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnEnter Ein Skriptblock, der aufgerufen wird, wenn der Benutzer die Eingabetaste drückt. Die Variable $EventData enthält den aktuellen Wert des Textfelds. ``` Required? false Position? 11 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnBlur Ein Skriptblock, der aufgerufen wird, wenn der Benutzer das Textfeld verlässt. Die Variable $EventData enthält den aktuellen Wert des Textfelds. ``` Required? false Position? 12 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Shrink Ob die Beschriftung standardmäßig verkleinert werden soll. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnValidate Ein Skriptblock, der aufgerufen wird, wenn der Benutzer das Textfeld verlässt. Die Variable $EventData enthält den aktuellen Wert des Textfelds. Wenn der Skriptblock ein Validierungsergebnis zurückgibt, das ungültig ist, wird es unterhalb des Textfelds angezeigt. ``` Required? false Position? 13 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -HelperText Ein Hilfetext, der unterhalb des Textfelds angezeigt wird. ``` Required? false Position? 14 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnChange Ein Skriptblock, der aufgerufen wird, wenn der Benutzer den Wert des Textfelds ändert. Die Variable $EventData enthält den aktuellen Wert des Textfelds. ``` Required? false Position? 15 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Minimum Der Mindestwert für ein Zahlen-Textfeld. ``` Required? false Position? 16 Default value 0 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Maximum Der Höchstwert für ein Zahlen-Textfeld. ``` Required? false Position? 17 Default value 0 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -MaximumLength Die maximale Länge des Texts im Textfeld. ``` Required? false Position? 18 Default value 0 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Sx Eine Hashtabelle mit themenbasierten Eigenschaften, die auf das Textfeld angewendet werden. ``` Required? false Position? 19 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Style Eine Hashtabelle mit CSS-Eigenschaften, die auf das Textfeld angewendet werden. ``` Required? false Position? 20 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -MaskPattern Ein Maskenmuster, das auf das Textfeld angewendet wird. Dies wird für Eingabemasken verwendet. Weitere Informationen finden Sie unter iMaskjs. ``` Required? false Position? 21 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Attributes ``` Required? false Position? 22 Default value @{} Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### Allgemeine Parameter Dieses Cmdlet unterstützt die allgemeinen Parameter: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable und OutVariable. Weitere Informationen finden Sie unter [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Ausgaben ### Beispiele #### Beispiel 1: Einfaches Textfeld ```powershell New-UDTextbox -Id 'textbox1' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Erstellt ein einfaches Textfeld. #### Beispiel 2: Passwort-Textfeld ```powershell New-UDTextbox -Id 'textbox2' -Label 'Password' -Placeholder 'Enter your password' -Type 'password' ``` Erstellt ein Passwort-Textfeld. #### Beispiel 3: E-Mail-Textfeld ```powershell New-UDTextbox -Id 'textbox3' -Label 'Email' -Placeholder 'Enter your email' -Type 'email' ``` Erstellt ein E-Mail-Textfeld. #### Beispiel 4: Deaktiviertes Textfeld ```powershell New-UDTextbox -Id 'textbox4' -Disabled -Label 'Disabled' -Placeholder 'Enter your name' -Value 'John Doe' ``` Erstellt ein deaktiviertes Textfeld. #### Beispiel 5: Textfeld mit Symbol ```powershell New-UDTextbox -Id 'textbox5' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Icon (New-UDIcon -Icon 'User') ``` Erstellt ein Textfeld mit einem Symbol. #### Beispiel 6: Textfeld mit Autofokus ```powershell New-UDTextbox -Id 'textbox6' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Autofocus ``` Erstellt ein Textfeld, das beim Laden der Seite automatisch fokussiert wird. #### Beispiel 7: Mehrzeiliges Textfeld ```powershell New-UDTextbox -Id 'textbox7' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Multiline ``` Erstellt ein mehrzeiliges Textfeld. #### Beispiel 8: Mehrzeiliges Textfeld mit 5 Zeilen ```powershell New-UDTextbox -Id 'textbox8' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Multiline -Rows 5 -RowsMax 10 ``` Erstellt ein mehrzeiliges Textfeld mit 5 Zeilen. #### Beispiel 9: Variante ```powershell New-UDTextbox -Id 'textbox9' -Variant 'filled' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Erstellt ein gefülltes Textfeld. #### Beispiel 10: OnEnter ```powershell New-UDTextbox -Id 'textbox10' -OnEnter { Show-UDToast -Message "You pressed enter!" } -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Erstellt ein Textfeld mit einem OnEnter-Ereignis. #### Beispiel 11: OnBlur ```powershell New-UDTextbox -Id 'textbox11' -OnBlur { Show-UDToast -Message "You left the textbox!" } -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Erstellt ein Textfeld mit einem OnBlur-Ereignis. #### Beispiel 12: OnValidate ```powershell New-UDTextbox -Id 'textbox12' -OnValidate { if ($EventData -eq 'John Doe') { return New-UDValidationResult -Valid } else { return New-UDValidationResult -ValidationError "You must enter John Doe" } } -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Erstellt ein Textfeld mit einem OnValidate-Ereignis. #### Beispiel 13: Hilfetext ```powershell New-UDTextbox -Id 'textbox13' -HelperText 'This is a helper text' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Erstellt ein Textfeld mit Hilfetext. #### Beispiel 14: OnChange ```powershell New-UDTextbox -Id 'textbox14' -OnChange { Show-UDToast -Message $EventData } -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Erstellt ein Textfeld mit einem OnChange-Ereignis. #### Beispiel 15: Minimum und Maximum ```powershell New-UDTextbox -Id 'textbox15' -Type 'number' -Minimum 1 -Maximum 100 ``` Erstellt ein Zahlen-Textfeld mit einem Mindest- und einem Höchstwert. #### Beispiel 16: Maskenmuster ```powershell New-UDTextbox -Id 'textbox16' -MaskPattern '+7 (000) 000-00-00' ``` Erstellt ein Textfeld mit einem Maskenmuster. --- # 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/powershell-befehle/new-udtextbox.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.