> 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/es/comandos-de-powershell/new-udtextbox.md). # New-UDTextbox ### Sinopsis Los cuadros de texto permiten a los usuarios introducir y editar texto. ### Sintaxis ```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] ] [] ``` ### Descripción Crea un cuadro de texto. Los cuadros de texto pueden usarse por sí solos o dentro de un New-UDForm. ### Parámetros #### -Id El ID del componente. Por defecto es un GUID aleatorio. ``` Required? false Position? 1 Default value ([Guid]::NewGuid()) Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Label Una etiqueta que se muestra encima de este cuadro de texto. ``` Required? false Position? 2 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Placeholder Un texto de marcador de posición que se coloca dentro del cuadro de texto. ``` Required? false Position? 3 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Value El valor actual del cuadro de texto. ``` Required? false Position? 4 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Type El tipo de cuadro de texto. Puede tener valores como 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 El icono que se muestra junto al cuadro de texto. Use New-UDIcon para crear un icono.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-RowsEl número de filas en un cuadro de texto multilínea.Required? falsePosition? 7Default value -1Accept pipeline input? falseAliasesAccept wildcard characters? false-RowsMaxEl número máximo de filas en un cuadro de texto multilínea.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 del cuadro de texto. Los valores válidos son "filled", "outlined", "standard"Required? falsePosition? 9Default value standardAccept pipeline input? falseAliasesAccept wildcard characters? false-ClassNameUna clase CSS que se aplica al cuadro de texto.Required? falsePosition? 10Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-OnEnterUn bloque de script que se llama cuando el usuario pulsa la tecla Enter. La variable $EventData contendrá el valor actual del cuadro de texto.Required? falsePosition? 11Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-OnBlurUn bloque de script que se llama cuando el usuario abandona el cuadro de texto. La variable $EventData contendrá el valor actual del cuadro de texto.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 bloque de script que se llama cuando el usuario abandona el cuadro de texto. La variable $EventData contendrá el valor actual del cuadro de texto. Si el bloque de script devuelve un resultado de validación no válido, este se mostrará debajo del cuadro de texto.Required? falsePosition? 13Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-HelperTextUn texto de ayuda que se muestra debajo del cuadro de texto.Required? falsePosition? 14Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-OnChangeUn bloque de script que se llama cuando el usuario cambia el valor del cuadro de texto. La variable $EventData contendrá el valor actual del cuadro de texto.Required? falsePosition? 15Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-MinimumEl valor mínimo para un cuadro de texto numérico.Required? falsePosition? 16Default value 0Accept pipeline input? falseAliasesAccept wildcard characters? false-MaximumEl valor máximo para un cuadro de texto numérico.Required? falsePosition? 17Default value 0Accept pipeline input? falseAliasesAccept wildcard characters? false-MaximumLengthLa longitud máxima del texto en el cuadro de texto.Required? falsePosition? 18Default value 0Accept pipeline input? falseAliasesAccept wildcard characters? false-SxUna tabla hash de propiedades basadas en el tema que se aplican al cuadro de texto.Required? falsePosition? 19Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-StyleUna tabla hash de propiedades CSS que se aplican al cuadro de texto.Required? falsePosition? 20Default valueAccept pipeline input? falseAliasesAccept wildcard characters? false-MaskPatternUn patrón de máscara que se aplica al cuadro de texto. Se usa para máscaras de entrada. Consulte iMaskjs para obtener más información.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 ( EJEMPLO 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/es/comandos-de-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.