TextBoxBase.Multiline Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit une valeur indiquant si ce contrôle est un contrôle 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 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.

Notes

É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.

Notes

Sur les systèmes d’exploitation japonais, si la propriété a la Multilinetruevaleur , 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é sur false si vous définissez la PasswordChar propriété.

Notes

Cette propriété est définie false sur 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é 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é.

Voir aussi

• Lines
• WordWrap
• ScrollBars