> 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/fr/commandes-powershell/new-udtextbox.md). # New-UDTextbox New-UDTextbox crée un champ de saisie de texte dans PowerShell Universal pour saisir et modifier des valeurs, utilisable seul ou à l'intérieur d'un formulaire. ### Synopsis Les zones de texte permettent aux utilisateurs de saisir et de modifier du texte. ### Syntaxe ```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] ] [] ``` ### Description Crée une zone de texte. Les zones de texte peuvent être utilisées seules ou à l'intérieur d'un New-UDForm. ### Paramètres #### -Id L'ID du composant. Par défaut, il s'agit d'un GUID aléatoire. ``` Required? false Position? 1 Default value ([Guid]::NewGuid()) Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Label Une étiquette à afficher au-dessus de cette zone de texte. ``` Required? false Position? 2 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Placeholder Un texte indicatif à placer dans la zone de texte. ``` Required? false Position? 3 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Value La valeur actuelle de la zone de texte. ``` Required? false Position? 4 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Type Le type de zone de texte. Il peut s'agir de valeurs telles que text, password ou email. ``` Required? false Position? 5 Default value text Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Disabled Indique si cette zone de texte est désactivée. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Icon L'icône à afficher à côté de la zone de texte. Utilisez New-UDIcon pour créer une icône. ``` Required? false Position? 6 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Autofocus Indique s'il faut mettre automatiquement le focus sur cette zone de texte. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Multiline Crée une zone de texte multiligne ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Rows Le nombre de lignes dans une zone de texte multiligne. ``` Required? false Position? 7 Default value -1 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -RowsMax Le nombre maximal de lignes dans une zone de texte multiligne. ``` Required? false Position? 8 Default value 9999 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -FullWidth Indique s'il faut faire en sorte que cette zone de texte occupe toute la largeur du contrôle parent. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Variant La variante de la zone de texte. Les valeurs valides sont "filled", "outlined", "standard" ``` Required? false Position? 9 Default value standard Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -ClassName Une classe CSS à appliquer à la zone de texte. ``` Required? false Position? 10 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnEnter Un bloc de script qui est appelé lorsque l'utilisateur appuie sur la touche Entrée. La variable $EventData contiendra la valeur actuelle de la zone de texte. ``` Required? false Position? 11 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnBlur Un bloc de script qui est appelé lorsque l'utilisateur quitte la zone de texte. La variable $EventData contiendra la valeur actuelle de la zone de texte. ``` Required? false Position? 12 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Shrink Indique s'il faut réduire l'étiquette par défaut. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnValidate Un bloc de script qui est appelé lorsque l'utilisateur quitte la zone de texte. La variable $EventData contiendra la valeur actuelle de la zone de texte. Si le bloc de script retourne un résultat de validation invalide, celui-ci sera affiché sous la zone de texte. ``` Required? false Position? 13 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -HelperText Un texte d'aide à afficher sous la zone de texte. ``` Required? false Position? 14 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnChange Un bloc de script qui est appelé lorsque l'utilisateur modifie la valeur de la zone de texte. La variable $EventData contiendra la valeur actuelle de la zone de texte. ``` Required? false Position? 15 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Minimum La valeur minimale d'une zone de texte numérique. ``` Required? false Position? 16 Default value 0 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Maximum La valeur maximale d'une zone de texte numérique. ``` Required? false Position? 17 Default value 0 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -MaximumLength La longueur maximale du texte dans la zone de texte. ``` Required? false Position? 18 Default value 0 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Sx Une table de hachage de propriétés basées sur le thème à appliquer à la zone de texte. ``` Required? false Position? 19 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Style Une table de hachage de propriétés CSS à appliquer à la zone de texte. ``` Required? false Position? 20 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -MaskPattern Un modèle de masque à appliquer à la zone de texte. Il est utilisé pour les masques de saisie. Consultez iMaskjs pour plus d'information. ``` 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 ``` #### Paramètres communs Cette applet de commande prend en charge les paramètres communs : Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable et OutVariable. Pour plus d'information, consultez [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Sorties ### Exemples #### Exemple 1 : Zone de texte de base ```powershell New-UDTextbox -Id 'textbox1' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Crée une zone de texte de base. #### Exemple 2 : Zone de texte de mot de passe ```powershell New-UDTextbox -Id 'textbox2' -Label 'Password' -Placeholder 'Enter your password' -Type 'password' ``` Crée une zone de texte de mot de passe. #### Exemple 3 : Zone de texte de courriel ```powershell New-UDTextbox -Id 'textbox3' -Label 'Email' -Placeholder 'Enter your email' -Type 'email' ``` Crée une zone de texte de courriel. #### Exemple 4 : Zone de texte désactivée ```powershell New-UDTextbox -Id 'textbox4' -Disabled -Label 'Disabled' -Placeholder 'Enter your name' -Value 'John Doe' ``` Crée une zone de texte désactivée. #### Exemple 5 : Zone de texte avec icône ```powershell New-UDTextbox -Id 'textbox5' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Icon (New-UDIcon -Icon 'User') ``` Crée une zone de texte avec une icône. #### Exemple 6 : Zone de texte avec focus automatique ```powershell New-UDTextbox -Id 'textbox6' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Autofocus ``` Crée une zone de texte qui obtiendra automatiquement le focus au chargement de la page. #### Exemple 7 : Zone de texte multiligne ```powershell New-UDTextbox -Id 'textbox7' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Multiline ``` Crée une zone de texte multiligne. #### Exemple 8 : Zone de texte multiligne avec 5 lignes ```powershell New-UDTextbox -Id 'textbox8' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Multiline -Rows 5 -RowsMax 10 ``` Crée une zone de texte multiligne avec 5 lignes. #### Exemple 9 : Variante ```powershell New-UDTextbox -Id 'textbox9' -Variant 'filled' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Crée une zone de texte remplie. #### Exemple 10 : OnEnter ```powershell New-UDTextbox -Id 'textbox10' -OnEnter { Show-UDToast -Message "You pressed enter!" } -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Crée une zone de texte avec un événement OnEnter. #### Exemple 11 : OnBlur ```powershell New-UDTextbox -Id 'textbox11' -OnBlur { Show-UDToast -Message "You left the textbox!" } -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Crée une zone de texte avec un événement OnBlur. #### Exemple 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' ``` Crée une zone de texte avec un événement OnValidate. #### Exemple 13 : Texte d'aide ```powershell New-UDTextbox -Id 'textbox13' -HelperText 'This is a helper text' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Crée une zone de texte avec un texte d'aide. #### Exemple 14 : OnChange ```powershell New-UDTextbox -Id 'textbox14' -OnChange { Show-UDToast -Message $EventData } -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' ``` Crée une zone de texte avec un événement OnChange. #### Exemple 15 : Minimum et maximum ```powershell New-UDTextbox -Id 'textbox15' -Type 'number' -Minimum 1 -Maximum 100 ``` Crée une zone de texte numérique avec une valeur minimale et une valeur maximale. #### Exemple 16 : Modèle de masque ```powershell New-UDTextbox -Id 'textbox16' -MaskPattern '+7 (000) 000-00-00' ``` Crée une zone de texte avec un modèle de masque. --- # 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/fr/commandes-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.