TextBoxBase.Multiline Property

Definition

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

Property Value

Boolean

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. Par défaut, il s’agit de false.The default is false.

Examples

L’exemple de code suivant utilise TextBox, une classe dérivée, pour créer un contrôle de TextBox 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 propriétés AcceptsTab, AcceptsReturnet 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

Remarks

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 propriété WordWrap est définie sur true, 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 propriété WordWrap est définie sur false, 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 texte à l’aide de la propriété ScrollBars 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.

Note

Étant donné que la valeur par défaut de la propriété Multiline est false, la taille par défaut d’un TextBox est conforme à la taille de police, même si vous redimensionnez le TextBox.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 votre TextBox, définissez sa propriété Multiline sur true.To get a consistent size for your TextBox, set its Multiline property to true.

Note

Sur les systèmes d’exploitation japonais, si la propriété Multiline est définie sur true, la définition de la propriété PasswordChar 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, définissez la propriété Multiline sur false si vous définissez la propriété PasswordChar.Therefore, on Japanese operating systems, set the Multiline property to false if you set the PasswordChar property.

Note

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

Pour un contrôle RichTextBox, la propriété RichTextBox.Multiline 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:

Applies to

See also