Vue d'ensemble de TextBoxTextBox Overview

La TextBox classe vous permet d’afficher ou de modifier du texte non mis en forme.The TextBox class enables you to display or edit unformatted text. Une utilisation courante d’un TextBox consiste à modifier du texte non mis en forme dans un formulaire.A common use of a TextBox is editing unformatted text in a form. Par exemple, un formulaire qui demande le nom de l’utilisateur, son numéro de téléphone, TextBox etc. utilise des contrôles pour l’entrée de texte.For example, a form asking for the user's name, phone number, etc would use TextBox controls for text input. Cette rubrique présente la TextBox classe et fournit des exemples d’utilisation de celle-ci langage XAML (eXtensible Application Markup Language)Extensible Application Markup Language (XAML) dans C#et.This topic introduces the TextBox class and provides examples of how to use it in both langage XAML (eXtensible Application Markup Language)Extensible Application Markup Language (XAML) and C#.

TextBox ou RichTextBox ?TextBox or RichTextBox?

Et permettent RichTextBox aux utilisateurs d’entrer du texte, mais les deux contrôles sont utilisés pour différents scénarios. TextBoxBoth TextBox and RichTextBox allow users to input text but the two controls are used for different scenarios. Un TextBox requiert moins de RichTextBox ressources système, et est donc idéal lorsque seul du texte brut doit être modifié (par exemple, utilisation dans un formulaire).A TextBox requires less system resources then a RichTextBox so it is ideal when only plain text needs to be edited (i.e., usage in a form). Un RichTextBox est un meilleur choix lorsqu’il est nécessaire que l’utilisateur modifie le texte mis en forme, les images, les tables ou tout autre contenu pris en charge.A RichTextBox is a better choice when it is necessary for the user to edit formatted text, images, tables, or other supported content. Par exemple, la modification d’un document, d’un article ou d’un blog nécessitant une mise en forme, des RichTextBoximages, etc. est mieux accomplie à l’aide d’un.For example, editing a document, article, or blog that requires formatting, images, etc is best accomplished using a RichTextBox. Le tableau ci-dessous résume les principales fonctionnalités TextBox de TextBoxet.The table below summarizes the primary features of TextBox and TextBox.

ContrôleControl Vérification de l’orthographe en temps réelReal-time Spellchecking Menu contextuelContext Menu Mise en forme des ToggleBold commandes telles que (CTR + B)Formatting commands like ToggleBold (Ctr+B) FlowDocumentcontenu tel que des images, des paragraphes, des tableaux, etc.FlowDocument content like images, paragraphs, tables, etc.
TextBox OuiYes OuiYes NonNo Non.No.
RichTextBox OuiYes OuiYes Oui (voir Vue d’ensemble de RichTextBox)Yes (see RichTextBox Overview) Oui (voir Vue d’ensemble de RichTextBox)Yes (see RichTextBox Overview)

Notes

Bien TextBox que ne prenne pas en charge les commandes ToggleBold de modification associées à la mise en forme telles que (CTR + B), MoveToLineEndde nombreuses commandes de base sont prises en charge par les deux contrôles tels que.Although TextBox does not support formatting related editing commands like ToggleBold (Ctr+B), many basic commands are supported by both controls such as MoveToLineEnd. Pour plus d'informations, voir EditingCommands.See EditingCommands for more information.

Les fonctionnalités prises TextBox en charge par sont décrites dans les sections ci-dessous.Features supported by TextBox are covered in the sections below. Pour plus d’informations RichTextBoxsur, consultez vue d’ensemble de RichTextBox.For more information about RichTextBox, see RichTextBox Overview.

Vérification de l’orthographe en temps réelReal-time Spellchecking

Vous pouvez activer la vérification de l’orthographe en temps TextBox réel RichTextBoxdans un ou un.You can enable real-time spellchecking in a TextBox or RichTextBox. Lorsque la vérification de l’orthographe est activée, une ligne rouge apparaît sous les mots mal orthographiés (voir l’illustration ci-dessous).When spellchecking is turned on, a red line appears underneath any misspelled words (see picture below).

Contrôle TextBox avec vérification de l’orthographeTextbox with spell-checking

Pour savoir comment activer la vérification de l’orthographe, consultez Activer la vérification de l’orthographe dans un contrôle d’édition de texte.See Enable Spell Checking in a Text Editing Control to learn how to enable spellchecking.

Menu contextuelContext Menu

Par défaut, TextBox et RichTextBox ont un menu contextuel qui s’affiche quand un utilisateur clique avec le bouton droit dans le contrôle.By default, both TextBox and RichTextBox have a context menu that appears when a user right-clicks inside the control. Ce menu contextuel permet à l’utilisateur de couper, de copier ou de coller du texte (voir l’image ci-dessous).The context menu allows the user to cut, copy, or paste (see picture below).

Contrôle TextBox avec un menu contextuelTextBox with context menu

Vous pouvez créer votre propre menu contextuel personnalisé pour remplacer le comportement par défaut.You can create your own custom context menu to override the default behavior. Pour plus d’informations, consultez Utiliser un menu contextuel personnalisé avec un TextBox.See Use a Custom Context Menu with a TextBox for more information.

Création de contrôles TextBoxCreating TextBoxes

Un TextBox peut être une seule ligne de hauteur ou comporter plusieurs lignes.A TextBox can be a single line in height or comprise multiple lines. Une seule ligne TextBox est idéale pour entrer de petites quantités de texte brut (c’est-à-dire « Nom », « Numéro de téléphone », etc. dans un formulaire).A single line TextBox is best for inputting small amounts of plain text (i.e. "Name", "Phone Number", etc. in a form). L’exemple suivant montre comment créer une ligne TextBoxunique.The following example shows how to create a single line TextBox.

<Page  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <StackPanel>
    <TextBox Width="200" MaxLength="100" />
  </StackPanel>
</Page>

Vous pouvez également créer un TextBox qui permet à l’utilisateur d’entrer plusieurs lignes de texte.You can also create a TextBox that allows the user to enter multiple lines of text. Par exemple, si votre formulaire vous demande une ébauche biographique de l’utilisateur, vous pouvez utiliser un TextBox qui prend en charge plusieurs lignes de texte.For example, if your form asked for a biographical sketch of the user, you would want to use a TextBox that supports multiple lines of text. L’exemple suivant montre comment utiliser langage XAML (eXtensible Application Markup Language)Extensible Application Markup Language (XAML) pour définir un TextBox contrôle qui se développe automatiquement pour s’adapter à plusieurs lignes de texte.The following example shows how to use langage XAML (eXtensible Application Markup Language)Extensible Application Markup Language (XAML) to define a TextBox control that automatically expands to accommodate multiple lines of text.

<TextBox
  Name="tbMultiLine"
  TextWrapping="Wrap"
  AcceptsReturn="True"
  VerticalScrollBarVisibility="Visible"
>
  This TextBox will allow the user to enter multiple lines of text.  When the RETURN key is pressed, 
  or when typed text reaches the edge of the text box, a new line is automatically inserted.
</TextBox>

L’affectation TextWrapping de la Wrap valeur à l’attribut provoque l’encapsulation du texte sur une nouvelle TextBox ligne lorsque le bord du contrôle est TextBox atteint, en développant automatiquement le contrôle pour inclure de l’espace pour une nouvelle ligne, si nécessaire.Setting the TextWrapping attribute to Wrap causes text to wrap to a new line when the edge of the TextBox control is reached, automatically expanding the TextBox control to include room for a new line, if necessary.

Le fait AcceptsReturn d’affecter true à l’attribut la valeur entraîne l’insertion d’une nouvelle ligne lorsque la touche retour est enfoncée, en développant de nouveau automatiquement pour inclure de l' TextBox espace pour une nouvelle ligne, si nécessaire.Setting the AcceptsReturn attribute to true causes a new line to be inserted when the RETURN key is pressed, once again automatically expanding the TextBox to include room for a new line, if necessary.

L' VerticalScrollBarVisibility attribut ajoute une barre TextBoxde défilement au, afin TextBox que le contenu du puisse être défilé si le se développe au TextBox -delà de la taille du frame ou de la fenêtre qui l’englobe.The VerticalScrollBarVisibility attribute adds a scroll bar to the TextBox, so that the contents of the TextBox can be scrolled through if the TextBox expands beyond the size of the frame or window that encloses it.

Pour plus d’informations sur les différentes tâches associées à TextBoxl’utilisation d’un, consultez les rubriques de procédures.For more information on different tasks associated with using a TextBox, see How-to Topics.

Détecter la modification du contenuDetect When Content Changes

En règle TextChanged générale, l’événement doit être utilisé pour détecter chaque fois TextBox que RichTextBox le texte d’un ou change, au lieu de vous attendre. KeyDownUsually the TextChanged event should be used to detect whenever the text in a TextBox or RichTextBox changes, rather then KeyDown as you might expect. Pour obtenir un exemple, consultez Détecter la modification du texte figurant dans un TextBox.See Detect When Text in a TextBox Has Changed for an example.

Voir aussiSee also