> 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/it/comandi-powershell/new-udtextbox.md). # New-UDTextbox ### Sinossi Le caselle di testo consentono agli utenti di inserire e modificare del testo. ### Sintassi ```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] ] [] ``` ### Descrizione Crea una casella di testo. Le caselle di testo possono essere utilizzate da sole o all'interno di un New-UDForm. ### Parametri #### -Id L'ID del componente. Per impostazione predefinita è un GUID casuale. ``` Required? false Position? 1 Default value ([Guid]::NewGuid()) Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Label Un'etichetta da mostrare sopra questa casella di testo. ``` Required? false Position? 2 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Placeholder Un segnaposto da inserire all'interno della casella di testo. ``` Required? false Position? 3 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Value Il valore corrente della casella di testo. ``` Required? false Position? 4 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Type Il tipo di casella di testo. Può assumere valori come text, password o email. ``` Required? false Position? 5 Default value text Accept pipeline input? false Aliases Accept wildcard characters? false -Disabled [] Whether this textbox is disabled. Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Icon L'icona da mostrare accanto alla casella di testo. Utilizzi New-UDIcon per creare un'icona.Required? falsePosition? 6Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false -Autofocus \[\] Whether to autofocus this textbox.Required? falsePosition? namedDefault value FalseAccept pipeline input? falseAliasesAccept wildcard characters? false -Multiline \[\] Creates a multiline textboxRequired? falsePosition? namedDefault value FalseAccept pipeline input? falseAliasesAccept wildcard characters? false-RowsIl numero di righe in una casella di testo multiriga.Required? falsePosition? 7Default value -1Accept pipeline input? falseAliasesAccept wildcard characters? false-RowsMaxIl numero massimo di righe in una casella di testo multiriga.Required? falsePosition? 8Default value 9999Accept pipeline input? falseAliasesAccept wildcard characters? false -FullWidth \[\] Whether to make this textbox take up the full width of the parent control.Required? falsePosition? namedDefault value FalseAccept pipeline input? falseAliasesAccept wildcard characters? false-VariantLa variante della casella di testo. I valori validi sono "filled", "outlined", "standard"Required? falsePosition? 9Default value standardAccept pipeline input? falseAliasesAccept wildcard characters? false-ClassNameUna classe CSS da applicare alla casella di testo.Required? falsePosition? 10Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-OnEnterUn blocco di script che viene chiamato quando l'utente preme il tasto Invio. La variabile $EventData conterrà il valore corrente della casella di testo.Required? falsePosition? 11Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-OnBlurUn blocco di script che viene chiamato quando l'utente esce dalla casella di testo. La variabile $EventData conterrà il valore corrente della casella di testo.Required? falsePosition? 12Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false -Shrink \[\] Whether to shrink label by default.Required? falsePosition? namedDefault value FalseAccept pipeline input? falseAliasesAccept wildcard characters? false-OnValidateUn blocco di script che viene chiamato quando l'utente esce dalla casella di testo. La variabile $EventData conterrà il valore corrente della casella di testo. Se il blocco di script restituisce un risultato di convalida non valido, questo verrà visualizzato sotto la casella di testo.Required? falsePosition? 13Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-HelperTextUn testo di supporto da mostrare sotto la casella di testo.Required? falsePosition? 14Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-OnChangeUn blocco di script che viene chiamato quando l'utente modifica il valore della casella di testo. La variabile $EventData conterrà il valore corrente della casella di testo.Required? falsePosition? 15Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-MinimumIl valore minimo per una casella di testo numerica.Required? falsePosition? 16Default value 0Accept pipeline input? falseAliasesAccept wildcard characters? false-MaximumIl valore massimo per una casella di testo numerica.Required? falsePosition? 17Default value 0Accept pipeline input? falseAliasesAccept wildcard characters? false-MaximumLengthLa lunghezza massima del testo nella casella di testo.Required? falsePosition? 18Default value 0Accept pipeline input? falseAliasesAccept wildcard characters? false-SxUna hashtable di proprietà basate sul tema da applicare alla casella di testo.Required? falsePosition? 19Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-StyleUna hashtable di proprietà CSS da applicare alla casella di testo.Required? falsePosition? 20Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-MaskPatternUn modello di maschera da applicare alla casella di testo. Viene utilizzato per le maschere di input. Consulti iMaskjs per maggiori informazioni.Required? falsePosition? 21Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-AttributesRequired? falsePosition? 22Default value @{}Accept pipeline input? falseAliasesAccept wildcard characters? false \ This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about\_CommonParameters ( ESEMPIO 1 --------------------------PS >New-UDTextbox -Id 'textbox1' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe'Basic textbox|Creates a basic textbox.-------------------------- EXAMPLE 2 --------------------------PS >New-UDTextbox -Id 'textbox2' -Label 'Password' -Placeholder 'Enter your password' -Type 'password'Password textbox|Creates a password textbox.-------------------------- EXAMPLE 3 --------------------------PS >New-UDTextbox -Id 'textbox3' -Label 'Email' -Placeholder 'Enter your email' -Type 'email'Email textbox|Creates an email textbox.-------------------------- EXAMPLE 4 --------------------------PS >New-UDTextbox -Id 'textbox4' -Disabled -Label 'Disabled' -Placeholder 'Enter your name' -Value 'John Doe'Disabled textbox|Creates a disabled textbox.-------------------------- EXAMPLE 5 --------------------------PS >New-UDTextbox -Id 'textbox5' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Icon (New-UDIcon -Icon 'User')Textbox with icon|Creates a textbox with an icon.-------------------------- EXAMPLE 6 --------------------------PS >New-UDTextbox -Id 'textbox6' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -AutofocusAutofocus textbox|Creates a textbox that will autofocus when the page loads.-------------------------- EXAMPLE 7 --------------------------PS >New-UDTextbox -Id 'textbox7' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -MultilineMultiline textbox|Creates a multiline textbox.-------------------------- EXAMPLE 8 --------------------------PS >New-UDTextbox -Id 'textbox8' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Multiline -Rows 5 -RowsMax 10Multiline textbox with 5 rows|Creates a multiline textbox with 5 rows.-------------------------- EXAMPLE 9 --------------------------PS >New-UDTextbox -Id 'textbox9' -Variant 'filled' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe'Variant|Creates a filled textbox.-------------------------- EXAMPLE 10 --------------------------PS >New-UDTextbox -Id 'textbox10' -OnEnter {PS > Show-UDToast -Message "You pressed enter!"PS > } -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe'OnEnter|Creates a textbox with an OnEnter event.-------------------------- EXAMPLE 11 --------------------------PS >New-UDTextbox -Id 'textbox11' -OnBlur {PS > Show-UDToast -Message "You left the textbox!"PS > } -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe'OnBlur|Creates a textbox with an OnBlur event.-------------------------- EXAMPLE 12 --------------------------PS >New-UDTextbox -Id 'textbox12' -OnValidate {PS > if ($EventData -eq 'John Doe') {PS > return New-UDValidationResult -ValidPS > }PS > else {PS > return New-UDValidationResult -ValidationError "You must enter John Doe"PS > }PS > } -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe'OnValidate|Creates a textbox with an OnValidate event.-------------------------- EXAMPLE 13 --------------------------PS >New-UDTextbox -Id 'textbox13' -HelperText 'This is a helper text' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe'Helper Text|Creates a textbox with helper text.-------------------------- EXAMPLE 14 --------------------------PS >New-UDTextbox -Id 'textbox14' -OnChange {PS > Show-UDToast -Message $EventDataPS > } -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe'OnChange|Creates a textbox with an OnChange event.-------------------------- EXAMPLE 15 --------------------------PS >New-UDTextbox -Id 'textbox15' -Type 'number' -Minimum 1 -Maximum 100Minimum and Maximum|Creates a number textbox with a minimum and maximum value.-------------------------- EXAMPLE 16 --------------------------PS >New-UDTextbox -Id 'textbox16' -MaskPattern '+7 (000) 000-00-00'Mask Pattern|Creates a textbox with a mask pattern. --- # 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/it/comandi-powershell/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.