TextBoxBase.WordWrap Propriedade

Definição

Indica se um controlo de caixa de texto multilinha envolve automaticamente as palavras no início da linha seguinte 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 de Propriedade

true se o controlo da caixa de texto multilinha envolver palavras; false se o controlo da caixa de texto deslocar-se automaticamente horizontalmente quando o utilizador escreve para além da extremidade direita do controlo. A predefinição é true.

Exemplos

O seguinte exemplo de código usa TextBox, uma classe derivada, para criar um controlo multilinha TextBox com barras de scroll verticais. Este exemplo também utiliza as AcceptsTabpropriedades , AcceptsReturn, e WordWrap para tornar o controlo da caixa de texto multilinha útil na 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

Observações

Se esta propriedade estiver definida para true, as barras horizontais de scroll não são exibidas independentemente da definição da ScrollBars propriedade.

Note

Na classe derivada, TextBox, o texto dentro do controlo irá sempre envolver independentemente da definição da propriedade desta propriedade, a menos que a TextAlign propriedade esteja definida para HorizontalAlignment.Left.

Aplica-se a