TextBoxBase.Multiline TextBoxBase.Multiline TextBoxBase.Multiline TextBoxBase.Multiline Property

Définition

Obtient ou définit une valeur indiquant si ce contrôle est un contrôle zone de texte multiligne.Gets or sets a value indicating whether this is a multiline text box control.

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.true if the control is a multiline text box control; otherwise, false. La valeur par défaut est false.The default is false.

Exemples

L’exemple de code suivant TextBoxutilise, une classe dérivée, pour créer TextBox un contrôle multiligne avec des barres de défilement verticales.The following code example uses TextBox, a derived class, to create a multiline TextBox control with vertical scroll bars. Cet exemple utilise également les AcceptsTabpropriétés AcceptsReturn, et WordWrap pour rendre le contrôle de zone de texte multiligne utile pour la création de documents texte.This example also uses the AcceptsTab, AcceptsReturn, and WordWrap properties to make the multiline text box control useful for creating text documents.

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.A multiline text box allows you to display more than one line of text in the control. Si la WordWrap propriété a la truevaleur, le texte entré dans la zone de texte multiligne est renvoyé à la ligne suivante dans le contrôle.If the WordWrap property is set to true, text entered into the multiline text box is wrapped to the next line in the control. Si la WordWrap propriété a la falsevaleur, le texte entré dans le contrôle zone de texte multiligne s’affichera sur la même ligne jusqu’à ce qu’un caractère de saut de ligne soit entré.If the WordWrap property is set to false, text entered into the multiline text box control will be displayed on the same line until a newline character is entered.

Les éléments suivants peuvent être utilisés comme caractères de saut de ligne :The following can be used as newline characters:

  • Environment.NewLine

  • ControlChars. CrLfControlChars.CrLf

  • vbCrLf (Visual Basic uniquement)vbCrLf (Visual Basic only)

Vous pouvez ajouter des barres de défilement à une zone de ScrollBars texte à l’aide de la propriété pour afficher des barres de défilement horizontales et/ou verticales.You can add scroll bars to a text box using the ScrollBars property to display horizontal and/or vertical scroll bars. Cela permet à l’utilisateur de faire défiler le texte qui s’étend au-delà des dimensions du contrôle.This allows the user to scroll through the text that extends beyond the dimensions of the control.

Notes

Étant donné que la valeur par Multiline défaut de falsela propriété est, la taille TextBox par défaut de a sera conforme à la taille de TextBoxpolice, même si vous redimensionnez.Because the default value of the Multiline property is false, the default size of a TextBox will be in accordance with the font size even if you resize the TextBox. Pour obtenir une taille cohérente pour TextBoxvotre, affectez la truevaleur à sa Multiline propriété.To get a consistent size for your TextBox, set its Multiline property to true.

Notes

Sur les systèmes d’exploitation japonais, Multiline si la propriété est truedéfinie sur, PasswordChar la définition de la propriété affichera le texte du mot de passe, compromettant ainsi la sécurité du système.On Japanese operating systems, if the Multiline property is set to true, setting the PasswordChar property will display the text of the password, thus compromising system security. Par conséquent, sur les systèmes d’exploitation japonais Multiline , affectez à false la propriété PasswordChar la valeur si vous définissez la propriété.Therefore, on Japanese operating systems, set the Multiline property to false if you set the PasswordChar property.

Notes

Cette propriété a la valeur false par défaut pour toutes les classes dérivées, à l’exception RichTextBox du contrôle.This property is set to false by default for all derived classes, with the exception of the RichTextBox control.

Pour un RichTextBox contrôle, la RichTextBox.Multiline propriété détermine si le contrôle est redimensionné automatiquement, comme suit :For a RichTextBox control, the RichTextBox.Multiline property affects whether or not the control will automatically resize, as follows:

S’applique à

Voir aussi