TextBoxBase.WordWrap Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Wskazuje, czy kontrolka wielowierszowego pola tekstowego automatycznie opakowuje wyrazy na początku następnego wiersza w razie potrzeby.

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

Wartość właściwości

Boolean

true jeśli kontrolka pola tekstowego wielowierszowego zawija wyrazy; false jeśli kontrolka pola tekstowego automatycznie przewija się w poziomie, gdy użytkownik wpisze obok prawej krawędzi kontrolki. Wartość domyślna to true.

Przykłady

W poniższym przykładzie kodu użyto TextBoxklasy pochodnej , aby utworzyć kontrolkę wielowierszową TextBox z pionowymi paskami przewijania. W tym przykładzie użyto AcceptsTabrównież właściwości , AcceptsReturni WordWrap , aby kontrolka wielowierszowego pola tekstowego przydała się do tworzenia dokumentów tekstowych.

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

Uwagi

Jeśli ta właściwość jest ustawiona na true, poziome paski przewijania nie są wyświetlane niezależnie od ScrollBars ustawienia właściwości.

Uwaga

W klasie TextBoxpochodnej tekst w kontrolce będzie zawsze zawijany niezależnie od ustawienia właściwości tej właściwości, chyba że TextAlign właściwość jest ustawiona na HorizontalAlignment.Left.