TextBoxBase.Multiline Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

TextBoxBase.cs

Obtient ou définit une valeur indiquant s’il s’agit d’un contrôle de zone de texte multiligne.

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é

Boolean

true si le contrôle est un contrôle de 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 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

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

Les éléments suivants peuvent être utilisés en tant que 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 parcourir le texte qui s’étend au-delà des dimensions du contrôle.

Note

Étant donné que la valeur par défaut de la Multiline propriété est false, la taille par défaut d’un TextBox sera conforme à la taille de police même si vous redimensionnez le TextBox. Pour obtenir une taille cohérente pour votre TextBox, définissez sa Multiline propriété sur true.

Note

Sur les systèmes d’exploitation japonais, si la Multiline propriété est définie truesur , la définition de la PasswordChar propriété affiche le texte du mot de passe, ce qui compromet la sécurité du système. Par conséquent, sur les systèmes d’exploitation japonais, définissez la Multiline propriété false sur si vous définissez la PasswordChar propriété.

Note

Cette propriété est définie false par défaut pour toutes les classes dérivées, à l’exception du RichTextBox contrôle.

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

• Si RichTextBox.AutoSize elle est définie sur et RichTextBox.Multiline sur laquelle elle est définie truetrue, RichTextBox ne sera pas redimensionnée automatiquement.

• Si RichTextBox.AutoSize elle est définie true sur et RichTextBox.Multiline sur laquelle elle est définie false, RichTextBox est automatiquement redimensionnée.

Voir aussi

• Lines
• WordWrap
• ScrollBars