TextBoxBase.Multiline Eigenschaft

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

Eigenschaftswert

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

Beispiele

Im folgenden Codebeispiel wird eine abgeleitete Klasse verwendet TextBox, um ein mehrlinienfähiges TextBox Steuerelement mit vertikalen Bildlaufleisten zu erstellen. In diesem Beispiel werden auch die AcceptsTabEigenschaften , AcceptsReturnund WordWrap verwendet, um das Mehrzeilen-Textfeld-Steuerelement zum Erstellen von Textdokumenten nützlich zu machen.

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

Hinweise

Mit einem mehrzeiligen Textfeld können Sie mehrere Textzeilen im Steuerelement anzeigen. Wenn die WordWrap -Eigenschaft auf truefestgelegt ist, wird der in das mehrzeilige Textfeld eingegebene Text in die nächste Zeile des Steuerelements umschlossen. Wenn die WordWrap -Eigenschaft auf falsefestgelegt ist, wird der in das mehrzeilige Textfeld-Steuerelement eingegebene Text in derselben Zeile angezeigt, bis ein Zeilenumbruchzeichen eingegeben wird.

Folgendes kann als Zeilenumbruchzeichen verwendet werden:

• Environment.NewLine

• ControlChars.CrLf

• vbCrLf (nur Visual Basic)

Sie können einem Textfeld Bildlaufleisten hinzufügen, indem Sie die ScrollBars -Eigenschaft verwenden, um horizontale und/oder vertikale Bildlaufleisten anzuzeigen. Dadurch kann der Benutzer durch den Text scrollen, der über die Dimensionen des Steuerelements hinausgeht.

Bei einem RichTextBox Steuerelement wirkt sich die RichTextBox.Multiline -Eigenschaft wie folgt auf die automatische Größenänderung des Steuerelements aus:

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

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

Gilt für:

Weitere Informationen

• Lines
• WordWrap
• ScrollBars