TextBoxBase.Multiline Propriété

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

public virtual bool Multiline { get; set; }

member this.Multiline : bool with get, set

Public Overridable Property Multiline As Boolean

Valeur de propriété

true s'il s'agit d'un contrôle zone de texte multiligne ; sinon, false. La valeur par défaut est false.

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 AcceptsTabpropriétés , AcceptsReturnet WordWrap pour rendre le contrôle de zone de texte multiligne utile à la création de 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

Une zone de texte multiligne vous permet d’afficher plusieurs lignes de texte dans le contrôle. Si la propriété a la WordWraptruevaleur , le texte entré dans la zone de texte multiligne est encapsulé à la ligne suivante du contrôle. Si la propriété a la WordWrapfalsevaleur , le texte entré dans le contrôle de zone de texte multiligne s’affiche sur la même ligne jusqu’à ce qu’un nouveau caractère de ligne soit entré.

Les éléments suivants peuvent être utilisés comme caractères de nouvelle ligne :

• Environment.NewLine

• ControlChars.CrLf

• vbCrLf (Visual Basic uniquement)

Vous pouvez ajouter des barres de défilement à une zone de texte à l’aide de la ScrollBars propriété pour afficher des barres de défilement horizontales et/ou verticales. Cela permet à l’utilisateur de faire défiler le texte qui s’étend au-delà des dimensions du contrôle.

Pour un RichTextBox contrôle, la RichTextBox.Multiline propriété détermine si le contrôle sera automatiquement redimensionné ou non, comme suit :

• Si RichTextBox.AutoSize est défini sur true et RichTextBox.Multiline a la valeur true, RichTextBox ne sera pas redimensionné automatiquement.

• Si RichTextBox.AutoSize a la valeur true et RichTextBox.Multiline a la valeur false, RichTextBox est automatiquement redimensionné.

S’applique à

Voir aussi

• Lines
• WordWrap
• ScrollBars