TextBoxBase.WordWrap Proprietà

Definizione

Indica se un controllo casella di testo su più righe manda automaticamente a capo le parole all'inizio della riga successiva quando è necessario.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

Valore della proprietà

Boolean

true se il controllo casella di testo su più righe manda a capo le parole; false se il controllo casella di testo procede automaticamente in orizzontale quando l'utente digita oltre il margine destro del controllo.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. Il valore predefinito è true.The default is true.

Esempio

L'esempio di codice seguente usa TextBox , una classe derivata, per creare un controllo su più righe TextBox con barre di scorrimento verticali.The following code example uses TextBox, a derived class, to create a multiline TextBox control with vertical scroll bars. In questo esempio vengono inoltre utilizzate le AcceptsTab AcceptsReturn proprietà, e WordWrap per rendere il controllo casella di testo su più righe utile per la creazione di documenti di testo.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

Commenti

Se questa proprietà è impostata su true , le barre di scorrimento orizzontali non vengono visualizzate indipendentemente dall' ScrollBars impostazione della proprietà.If this property is set to true, horizontal scroll bars are not displayed regardless of the ScrollBars property setting.

Nota

Nella classe derivata, TextBox , il testo all'interno del controllo viene sempre sottoposto a wrapping indipendentemente dall'impostazione della proprietà di questa proprietà, a meno che la TextAlign proprietà non sia impostata su 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.

Si applica a