TextBoxBase.Multiline Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

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

Boolean

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.

Hinweis

Da der Standardwert der Multiline -Eigenschaft ist, entspricht falsedie Standardgröße von dem TextBox Schriftgrad, auch wenn Sie die Größe von TextBoxändern. Um eine konsistente Größe für Ihre TextBoxzu erhalten, legen Sie die Multiline -Eigenschaft auf fest true.

Hinweis

Wenn die Multiline Eigenschaft auf japanischen Betriebssystemen auf truefestgelegt ist, wird durch Festlegen der PasswordChar Eigenschaft der Text des Kennworts angezeigt, wodurch die Systemsicherheit beeinträchtigt wird. Legen Sie daher unter japanischen Betriebssystemen die Multiline -Eigenschaft auf fest false , wenn Sie die PasswordChar -Eigenschaft festlegen.

Hinweis

Diese Eigenschaft ist für alle abgeleiteten Klassen mit Ausnahme des RichTextBox -Steuerelements standardmäßig auf false festgelegt.

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.

Weitere Informationen

• Lines
• WordWrap
• ScrollBars