TextBoxBase.Multiline Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define um valor que indica se este é um controle de caixa de texto de várias linhas.

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 da propriedade

Boolean

true se o controle for um controle de caixa de texto de várias linhas; caso contrário, false. O padrão é false.

Exemplos

O exemplo de código a seguir usa TextBox, uma classe derivada, para criar um controle de várias linhas TextBox com barras de rolagem verticais. Este exemplo também usa as AcceptsTabpropriedades , AcceptsReturne WordWrap para tornar o controle de caixa de texto de várias linhas útil para criar 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

Uma caixa de texto de várias linhas permite exibir mais de uma linha de texto no controle. Se a WordWrap propriedade estiver definida truecomo , o texto inserido na caixa de texto de várias linhas será encapsulado para a próxima linha no controle. Se a WordWrap propriedade for definida falsecomo , o texto inserido no controle de caixa de texto de várias linhas será exibido na mesma linha até que um caractere de nova linha seja inserido.

O seguinte pode ser usado como caracteres de nova linha:

• Environment.NewLine

• ControlChars.CrLf

• vbCrLf (somente Visual Basic)

Você pode adicionar barras de rolagem a uma caixa de texto usando a ScrollBars propriedade para exibir barras de rolagem horizontais e/ou verticais. Isso permite que o usuário role pelo texto que se estende além das dimensões do controle.

Observação

Como o valor padrão da Multiline propriedade é false, o tamanho padrão de um TextBox será de acordo com o tamanho da fonte, mesmo se você redimensionar o TextBox. Para obter um tamanho consistente para o TextBox, defina sua Multiline propriedade como true.

Observação

Em sistemas operacionais japoneses, se a Multiline propriedade estiver definida truecomo , definir a PasswordChar propriedade exibirá o texto da senha, comprometendo assim a segurança do sistema. Portanto, em sistemas operacionais japoneses, defina a Multiline propriedade false como se você definir a PasswordChar propriedade .

Observação

Essa propriedade é definida false como por padrão para todas as classes derivadas, com exceção do RichTextBox controle .

Para um RichTextBox controle , a RichTextBox.Multiline propriedade afeta se o controle será redimensionar automaticamente, da seguinte maneira:

• Se RichTextBox.AutoSize for definido true como e RichTextBox.Multiline estiver definido truecomo , RichTextBox não será redimensionamento automático.

• Se RichTextBox.AutoSize for definido true como e RichTextBox.Multiline estiver definido falsecomo , RichTextBox será redimensionamento automático.

Confira também

• Lines
• WordWrap
• ScrollBars