TextBoxBase.WordWrap Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Indica se um controle de caixa de texto de várias linhas automaticamente quebra o texto para o início da próxima linha, quando necessário.

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

Valor da propriedade

Boolean

true se o controle de caixa de texto de várias linhas quebra o texto; false se o controle de caixa de texto automaticamente rolar horizontalmente quando o usuário digitar além da borda direita do controle. O padrão é true.

Exemplos

O exemplo de código a seguir usa TextBoxuma classe derivada para criar um controle de várias linhas TextBox com barras de rolagem verticais. Este exemplo também usa as AcceptsTabpropriedades e WordWrap , AcceptsReturnpara tornar o controle de caixa de texto de várias linhas útil para a criação de documentos de texto.

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

Comentários

Se essa propriedade estiver definida como true, as barras de rolagem horizontal não serão exibidas independentemente da configuração da ScrollBars propriedade.

Observação

Na classe derivada, TextBoxo texto dentro do controle sempre será encapsulado independentemente da configuração da propriedade dessa propriedade, a menos que a TextAlign propriedade esteja definida como HorizontalAlignment.Left.