TextBoxBase.WordWrap Właściwość

Definicja

Wskazuje, czy wielowierszowa kontrolka pola tekstowego automatycznie zawija wyrazy do początku następnego wiersza, gdy jest to konieczne.Indicates whether a multiline text box control automatically wraps words to the beginning of the next line when necessary.

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

true, jeśli wielowierszowa kontrolka pola tekstowego zawija słowa; false, czy formant pola tekstowego jest automatycznie przewijany w poziomie, gdy użytkownik wpisze poza prawą krawędź formantu.true if the multiline text box control wraps words; false if the text box control automatically scrolls horizontally when the user types past the right edge of the control. Wartość domyślna to true.The default is true.

Przykłady

Poniższy przykład kodu używa TextBox, klasy pochodnej, do tworzenia wielowierszowego formantu TextBox z pionowymi paskami przewijania.The following code example uses TextBox, a derived class, to create a multiline TextBox control with vertical scroll bars. Ten przykład używa również właściwości AcceptsTab, AcceptsReturni WordWrap, aby formant wielowierszowego pola tekstowego był przydatny do tworzenia dokumentów tekstowych.This example also uses the AcceptsTab, AcceptsReturn, and WordWrap properties to make the multiline text box control useful for creating text documents.

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 ustawienia właściwości ScrollBars.If this property is set to true, horizontal scroll bars are not displayed regardless of the ScrollBars property setting.

Uwaga

W klasie pochodnej TextBox, tekst w kontrolce zawsze będzie zawijany niezależnie od ustawienia właściwości tej właściwości, chyba że właściwość TextAlign jest ustawiona na HorizontalAlignment.Left.In the derived class, TextBox, text within the control will always wrap regardless of the property setting of this property unless the TextAlign property is set to HorizontalAlignment.Left.

Dotyczy