TextBoxBase.WordWrap Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt an, ob im Steuerelement für ein mehrzeiliges Textfeld bei Bedarf automatisch ein Zeilenumbruch durchgeführt wird.

public:
 property bool WordWrap { bool get(); void set(bool value); };

public bool WordWrap { get; set; }

member this.WordWrap : bool with get, set

Public Property WordWrap As Boolean

Eigenschaftswert

Boolean

true, wenn in die Zeilen in dem mehrzeiligen Textfeld-Steuerelement umbrochen werden, false, wenn das Textfeld-Steuerelement automatisch einen horizontalen Bildlauf durchführt, wenn der Benutzer über den rechten Rand des Steuerelement hinaus schreibt. Der Standardwert ist true.

Beispiele

Im folgenden Codebeispiel wird eine abgeleitete Klasse verwendet TextBox, um ein mehrlineiges TextBox Steuerelement mit vertikalen Bildlaufleisten zu erstellen. In diesem Beispiel werden auch die AcceptsTabEigenschaften , und WordWrap verwendet, AcceptsReturnum das Mehrzeilen-Textfeld-Steuerelement für das 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

Wenn diese Eigenschaft auf truefestgelegt ist, werden horizontale Bildlaufleisten unabhängig von der ScrollBars Eigenschaftseinstellung nicht angezeigt.

Hinweis

In der abgeleiteten Klasse wird text im Steuerelement immer umgebrochen, TextBoxunabhängig von der Eigenschaftseinstellung dieser Eigenschaft, es sei denn, die TextAlign -Eigenschaft ist auf HorizontalAlignment.Leftfestgelegt.

Gilt für:

Freigeben über