TextBoxBase.Multiline Propriedade

public:
 virtual property bool Multiline { bool get(); void set(bool value); };

public virtual bool Multiline { get; set; }

member this.Multiline : bool with get, set

Public Overridable Property Multiline As Boolean

Valor de Propriedade

true se o controlo for um controlo de caixa de texto multilinha; caso contrário, false. A predefinição é false.

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

Uma caixa de texto multilinha permite-lhe mostrar mais do que uma linha de texto no controlo. Se a WordWrap propriedade estiver definida para true, o texto introduzido na caixa de texto multilinha é enrolado para a linha seguinte no controlo. Se a WordWrap propriedade estiver definida para false, o texto introduzido no controlo da caixa de texto multilinha será exibido na mesma linha até que um carácter de nova linha seja inserido.

Os seguintes podem ser usados como caracteres de nova linha:

• Environment.NewLine

• ControlChars.CrLf

• vbCrLf (apenas Visual Basic)

Podes adicionar barras de deslocamento a uma caixa de texto usando a ScrollBars propriedade para mostrar barras de deslocamento horizontais e/ou verticais. Isto permite ao utilizador percorrer o texto que se estende para além das dimensões do controlo.

Para um RichTextBox controlo, a RichTextBox.Multiline propriedade afeta se o controlo irá ou não redimensionar-se automaticamente, da seguinte forma:

• Se RichTextBox.AutoSize estiver definido como true e RichTextBox.Multiline for definido para true, RichTextBox não irá redimensionar automaticamente.

• Se RichTextBox.AutoSize for definido para true e RichTextBox.Multiline for definido para false, RichTextBox irá automaticamente redimensionar.

Ver também

• Lines
• WordWrap
• ScrollBars