TextBoxBase.WordWrap Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

TextBoxBase.cs

Indique si un contrôle de zone de texte multiligne encapsule automatiquement les mots au début de la ligne suivante si nécessaire.

public:
 property bool WordWrap { bool get(); void set(bool value); };

public bool WordWrap { get; set; }

member this.WordWrap : bool with get, set

Public Property WordWrap As Boolean

Valeur de propriété

Boolean

true si le contrôle de zone de texte multiligne encapsule les mots ; false si le contrôle de zone de texte fait défiler automatiquement horizontalement lorsque l’utilisateur tape au-delà du bord droit du contrôle. La valeur par défaut est true.

Exemples

L’exemple de code suivant utilise TextBox, une classe dérivée, pour créer un contrôle multiligne TextBox avec des barres de défilement verticales. Cet exemple utilise également les propriétés et AcceptsReturnWordWrap les AcceptsTabpropriétés pour rendre le contrôle de zone de texte multiligne utile pour créer des documents texte.

public:
   void CreateMyMultilineTextBox()
   {
      // Create an instance of a TextBox control.
      TextBox^ textBox1 = gcnew TextBox;
      
      // Set the Multiline property to true.
      textBox1->Multiline = true;
      // Add vertical scroll bars to the TextBox control.
      textBox1->ScrollBars = ScrollBars::Vertical;
      // Allow the RETURN key in the TextBox control.
      textBox1->AcceptsReturn = true;
      // Allow the TAB key to be entered in the TextBox control.
      textBox1->AcceptsTab = true;
      // Set WordWrap to true to allow text to wrap to the next line.
      textBox1->WordWrap = true;
      // Set the default text of the control.
      textBox1->Text = "Welcome!" + Environment::NewLine + "Second Line";
   }

public void CreateMyMultilineTextBox()
 {
    // Create an instance of a TextBox control.
    TextBox textBox1 = new TextBox();
    
    // Set the Multiline property to true.
    textBox1.Multiline = true;
    // Add vertical scroll bars to the TextBox control.
    textBox1.ScrollBars = ScrollBars.Vertical;
    // Allow the RETURN key in the TextBox control.
    textBox1.AcceptsReturn = true;
    // Allow the TAB key to be entered in the TextBox control.
    textBox1.AcceptsTab = true;
    // Set WordWrap to true to allow text to wrap to the next line.
    textBox1.WordWrap = true;
    // Set the default text of the control.
    textBox1.Text = "Welcome!" + Environment.NewLine + "Second Line";
 }

Public Sub CreateMyMultilineTextBox()
    ' Create an instance of a TextBox control.
    Dim textBox1 As New TextBox()
    
    ' Set the Multiline property to true.
    textBox1.Multiline = True
    ' Add vertical scroll bars to the TextBox control.
    textBox1.ScrollBars = ScrollBars.Vertical
    ' Allow the RETURN key in the TextBox control.
    textBox1.AcceptsReturn = True
    ' Allow the TAB key to be entered in the TextBox control.
    textBox1.AcceptsTab = True
    ' Set WordWrap to true to allow text to wrap to the next line.
    textBox1.WordWrap = True
    ' Set the default text of the control.
    textBox1.Text = "Welcome!" & Environment.NewLine & "Second Line"
End Sub

Remarques

Si cette propriété est définie truesur , les barres de défilement horizontales ne sont pas affichées indépendamment du paramètre de ScrollBars propriété.

Note

Dans la classe dérivée, TextBoxle texte dans le contrôle est toujours encapsulé indépendamment du paramètre de propriété de cette propriété, sauf si la TextAlign propriété est définie HorizontalAlignment.Leftsur .