TextBoxBase.Multiline-Eigenschaft

Ruft einen Wert ab, der angibt, ob dies ein mehrzeiliges Textfeld-Steuerelement ist, oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Overridable Property Multiline As Boolean
'Usage
Dim instance As TextBoxBase
Dim value As Boolean

value = instance.Multiline

instance.Multiline = value

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

[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)

public function get Multiline () : boolean

public function set Multiline (value : boolean)

Eigenschaftenwert

true, wenn es sich um ein mehrzeiliges Steuerelement handelt, andernfalls false. Der Standardwert ist false.

Hinweise

Mit einem mehrzeiligen Textfeld können mehr als eine Textzeile im Steuerelement angezeigt werden. Wenn die WordWrap-Eigenschaft auf true festgelegt wurde, wird der in das mehrzeilige Textfeld eingegebene Text im Steuerelement umbrochen. Wenn die WordWrap-Eigenschaft auf false festgelegt wurde, wird der in das mehrzeilige Textfeld-Steuerelement eingegebene Text so lange in derselben Zeile angezeigt, bis ein Zeilenumbruchzeichen eingegeben wird.

Folgende Zeilenumbruchzeichen können verwendet werden:

• Environment.NewLine

• ControlChars.CrLf

• vbCrLf (nur Visual Basic)

Einem Textfeld können Bildlaufleisten hinzugefügt werden, indem mit der ScrollBars-Eigenschaft horizontale und/oder vertikale Bildlaufleisten angezeigt werden. Dadurch können Benutzer sich durch einen Bildlauf Text anzeigen lassen, der über den Rand des Steuerelements hinausgeht.

Bei einem RichTextBox-Steuerelement hat die RichTextBox.Multiline-Eigenschaft Einfluss darauf, ob die Größe des Steuerelements automatisch geändert wird. Hierbei gilt Folgendes:

• Wenn RichTextBox.AutoSize auf true und RichTextBox.Multiline auf true festgelegt sind, wird die Größe von RichTextBox nicht automatisch geändert.

• Wenn RichTextBox.AutoSize auf true und RichTextBox.Multiline auf false festgelegt sind, wird die Größe von RichTextBox automatisch geändert.

Beispiel

Im folgenden Codebeispiel wird mit der abgeleiteten Klasse TextBox ein mehrzeiliges TextBox-Steuerelement mit vertikalen Bildlaufleisten erstellt. In diesem Beispiel werden außerdem die Eigenschaften AcceptsTab, AcceptsReturn und WordWrap verwendet, damit das mehrzeilige Textfeld-Steuerelement zum Erstellen von Textdokumenten eingesetzt werden kann.

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TextBoxBase-Klasse
TextBoxBase-Member
System.Windows.Forms-Namespace
TextBoxBase.Lines-Eigenschaft
WordWrap
TextBox.ScrollBars-Eigenschaft