> 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 New-UDTextbox crea un campo de entrada de texto en PowerShell Universal para introducir y editar valores, utilizable de forma independiente o dentro de un formulario. ### 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. De forma predeterminada 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 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 tomar valores como text, password o email. ``` Required? false Position? 5 Default value text Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Disabled Si este cuadro de texto está deshabilitado. ``` 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? false Position? 6 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Autofocus Si se debe enfocar automáticamente este cuadro de texto. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Multiline Crea un cuadro de texto multilínea ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Rows El número de filas de un cuadro de texto multilínea. ``` Required? false Position? 7 Default value -1 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -RowsMax El número máximo de filas de un cuadro de texto multilínea. ``` Required? false Position? 8 Default value 9999 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -FullWidth Si este cuadro de texto debe ocupar todo el ancho del control principal. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Variant La variante del cuadro de texto. Los valores válidos son "filled", "outlined", "standard" ``` Required? false Position? 9 Default value standard Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -ClassName Una clase CSS que se aplica al cuadro de texto. ``` Required? false Position? 10 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnEnter Un bloque de script que se llama cuando el usuario pulsa la tecla Intro. La variable $EventData contendrá el valor actual del cuadro de texto. ``` Required? false Position? 11 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnBlur Un bloque de script que se llama cuando el usuario sale del cuadro de texto. La variable $EventData contendrá el valor actual del cuadro de texto. ``` Required? false Position? 12 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Shrink Si se debe reducir la etiqueta de forma predeterminada. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnValidate Un bloque de script que se llama cuando el usuario sale del 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, se mostrará debajo del cuadro de texto. ``` Required? false Position? 13 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -HelperText Un texto de ayuda que se muestra debajo del cuadro de texto. ``` Required? false Position? 14 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnChange Un 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? false Position? 15 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Minimum El valor mínimo para un cuadro de texto numérico. ``` Required? false Position? 16 Default value 0 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Maximum El valor máximo para un cuadro de texto numérico. ``` Required? false Position? 17 Default value 0 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -MaximumLength La longitud máxima del texto en el cuadro de texto. ``` Required? false Position? 18 Default value 0 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Sx Una tabla hash de propiedades basadas en el tema que se aplican al cuadro de texto. ``` Required? false Position? 19 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Style Una tabla hash de propiedades CSS que se aplican al cuadro de texto. ``` Required? false Position? 20 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -MaskPattern Un patrón de máscara que se aplica al cuadro de texto. Se utiliza para máscaras de entrada. Consulte iMaskjs para obtener más información. ``` 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 ``` #### Parámetros comunes Este cmdlet admite los parámetros comunes: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable y OutVariable. Para obtener más información, consulte [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Salidas ### Ejemplos #### Ejemplo 1: cuadro de texto básico ```powershell New-UDTextbox -Id 'textbox1' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Crea un cuadro de texto básico. #### Ejemplo 2: cuadro de texto de contraseña ```powershell New-UDTextbox -Id 'textbox2' -Label 'Password' -Placeholder 'Enter your password' -Type 'password' ``` Crea un cuadro de texto de contraseña. #### Ejemplo 3: cuadro de texto de correo electrónico ```powershell New-UDTextbox -Id 'textbox3' -Label 'Email' -Placeholder 'Enter your email' -Type 'email' ``` Crea un cuadro de texto de correo electrónico. #### Ejemplo 4: cuadro de texto deshabilitado ```powershell New-UDTextbox -Id 'textbox4' -Disabled -Label 'Disabled' -Placeholder 'Enter your name' -Value 'John Doe' ``` Crea un cuadro de texto deshabilitado. #### Ejemplo 5: cuadro de texto con icono ```powershell New-UDTextbox -Id 'textbox5' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Icon (New-UDIcon -Icon 'User') ``` Crea un cuadro de texto con un icono. #### Ejemplo 6: cuadro de texto con enfoque automático ```powershell New-UDTextbox -Id 'textbox6' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Autofocus ``` Crea un cuadro de texto que se enfocará automáticamente cuando se cargue la página. #### Ejemplo 7: cuadro de texto multilínea ```powershell New-UDTextbox -Id 'textbox7' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Multiline ``` Crea un cuadro de texto multilínea. #### Ejemplo 8: cuadro de texto multilínea con 5 filas ```powershell New-UDTextbox -Id 'textbox8' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Multiline -Rows 5 -RowsMax 10 ``` Crea un cuadro de texto multilínea con 5 filas. #### Ejemplo 9: variante ```powershell New-UDTextbox -Id 'textbox9' -Variant 'filled' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Crea un cuadro de texto relleno. #### Ejemplo 10: OnEnter ```powershell New-UDTextbox -Id 'textbox10' -OnEnter { Show-UDToast -Message "You pressed enter!" } -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Crea un cuadro de texto con un evento OnEnter. #### Ejemplo 11: OnBlur ```powershell New-UDTextbox -Id 'textbox11' -OnBlur { Show-UDToast -Message "You left the textbox!" } -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Crea un cuadro de texto con un evento OnBlur. #### Ejemplo 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' ``` Crea un cuadro de texto con un evento OnValidate. #### Ejemplo 13: texto de ayuda ```powershell New-UDTextbox -Id 'textbox13' -HelperText 'This is a helper text' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Crea un cuadro de texto con texto de ayuda. #### Ejemplo 14: OnChange ```powershell New-UDTextbox -Id 'textbox14' -OnChange { Show-UDToast -Message $EventData } -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Crea un cuadro de texto con un evento OnChange. #### Ejemplo 15: mínimo y máximo ```powershell New-UDTextbox -Id 'textbox15' -Type 'number' -Minimum 1 -Maximum 100 ``` Crea un cuadro de texto numérico con un valor mínimo y máximo. #### Ejemplo 16: patrón de máscara ```powershell New-UDTextbox -Id 'textbox16' -MaskPattern '+7 (000) 000-00-00' ``` Crea un cuadro de texto con un patrón de máscara. --- # 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.