TextBoxBase.WordWrap Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

TextBoxBase.cs

Indica se un controllo casella di testo su più righe esegue automaticamente il wrapping delle parole all'inizio della riga successiva quando necessario.

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 esegue il wrapping delle parole; false se il controllo casella di testo scorre automaticamente orizzontalmente quando l'utente digita oltre il bordo destro del controllo. Il valore predefinito è true.

Esempio

Nell'esempio di codice seguente viene TextBoxusato , una classe derivata, per creare un controllo multilinea TextBox con barre di scorrimento verticali. In questo esempio vengono usate anche le AcceptsTabproprietà , AcceptsReturne WordWrap per rendere utile il controllo casella di testo su più righe per la creazione di documenti di testo.

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'impostazione della ScrollBars proprietà.

Annotazioni

Nella classe derivata, TextBoxil testo all'interno del controllo eseguirà sempre il wrapping indipendentemente dall'impostazione della proprietà di questa proprietà, a meno che la TextAlign proprietà non sia impostata su HorizontalAlignment.Left.