TextBoxBase.Multiline, propriété (System.Windows.Forms)

Multiline, propriété

Passer à l'affichage pour faible bande passante

Réduire tout

Filtre de language

Cette page est spécifique à

Microsoft Visual Studio 2005/.NET Framework 2.0

D'autres versions sont également disponibles pour :

Microsoft Visual Studio 2008/.NET Framework 3.5

Bibliothèque de classes .NET Framework

TextBoxBase.Multiline, propriété

Obtient ou définit une valeur indiquant si ce contrôle est un contrôle zone de texte multiligne.

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

Syntaxe

Visual Basic (Déclaration)

<LocalizableAttribute(True)> _
Public Overridable Property Multiline As Boolean

Visual Basic (Utilisation)

Dim instance As TextBoxBase
Dim value As Boolean

value = instance.Multiline

instance.Multiline = value

[LocalizableAttribute(true)] 
public virtual bool Multiline { get; set; }

C++

[LocalizableAttribute(true)] 
public:
virtual property bool Multiline {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Multiline ()

/** @property */
public void set_Multiline (boolean value)

JScript

public function get Multiline () : boolean

public function set Multiline (value : boolean)

Valeur de la propriété

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

Notes

Une zone de texte multiligne permet d'afficher plusieurs lignes de texte dans le contrôle. Si la propriété WordWrap a la valeur true, le texte entré dans la zone de texte multiligne passe à la ligne dans le contrôle. Si la propriété WordWrap a la valeur false, le texte entré dans le contrôle zone de texte multiligne ne change de ligne que lorsqu'un caractère de saut de ligne est entré.

Les caractères suivants peuvent être utilisés comme caractères de saut de ligne :

Environment.NewLine
ControlChars.CrLf
vbCrLf (Visual Basic seulement).

Il est possible d'ajouter à une zone de texte des barres de défilement horizontale et/ou verticale, à l'aide de la propriété ScrollBars. Elles permettent de faire défiler le texte lorsqu'il dépasse les limites du contrôle.

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

Remarque
Sur les systèmes d'exploitation japonais, si la propriété Multiline a la valeur true, la définition de la propriété PasswordChar affichera le texte du mot de passe, compromettant ainsi la sécurité du système. 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.

Remarque
Par défaut, cette propriété a la valeur false pour toutes les classes dérivées, à l'exception du contrôle RichTextBox.

Pour un contrôle RichTextBox, la propriété RichTextBox.Multiline indique si le contrôle se redimensionnera automatiquement ou non, comme suit :

Si RichTextBox.AutoSize a la valeur true et RichTextBox.Multiline a la valeur true, RichTextBox ne se redimensionnera pas automatiquement.
Si RichTextBox.AutoSize a la valeur true et RichTextBox.Multiline a la valeur false, RichTextBox ne se redimensionnera pas automatiquement.

Exemple

L'exemple de code suivant utilise une classe dérivée, TextBox, pour créer un contrôle TextBox multiligne contenant des barres de défilement verticales. Il utilise également les propriétés AcceptsTab AcceptsReturn et WordWrap, qui permettent d'utiliser le contrôle zone de texte multiligne lors de la création de documents de texte.

Visual Basic

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

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";
 }

C++

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.set_Multiline(true);
    // Add vertical scroll bars to the TextBox control.
    textBox1.set_ScrollBars(ScrollBars.Vertical);
    // Allow the RETURN key in the TextBox control.
    textBox1.set_AcceptsReturn(true);
    // Allow the TAB key to be entered in the TextBox control.
    textBox1.set_AcceptsTab(true);
    // Set WordWrap to true to allow text to wrap to the next line.
    textBox1.set_WordWrap(true);
    // Set the default text of the control.
    textBox1.set_Text("Welcome!" + Environment.get_NewLine()
        + "Second Line");
} //CreateMyMultilineTextBox

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

TextBoxBase, classe
Membres TextBoxBase
System.Windows.Forms, espace de noms
TextBoxBase.Lines, propriété
WordWrap
TextBox.ScrollBars, propriété

Mots clés

: Ajouter un mot clé

Contenu de la communauté

Ajouter du contenu

Annotations

Gérer votre profil | Contactez-nous | Newsletter MSDN