TextBoxBase.Multiline Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece un valor que indica si es un control de cuadro de texto multilínea.

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 propiedad

Boolean

true si el control es un control de cuadro de texto multilínea; en caso contrario, false. De manera predeterminada, es false.

Ejemplos

En el ejemplo de código siguiente se usa TextBox, una clase derivada, para crear un control de varias líneas TextBox con barras de desplazamiento verticales. En este ejemplo también se usan las AcceptsTabpropiedades , AcceptsReturny WordWrap para que el control de cuadro de texto de varias líneas sea útil para crear 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

Comentarios

Un cuadro de texto de varias líneas permite mostrar más de una línea de texto en el control. Si la propiedad se establece trueen , el WordWrap texto escrito en el cuadro de texto de varias líneas se ajusta a la siguiente línea del control. Si la WordWrap propiedad se establece falseen , el texto escrito en el control de cuadro de texto de varias líneas se mostrará en la misma línea hasta que se escriba un carácter de nueva línea.

Se puede usar lo siguiente como caracteres de nueva línea:

• Environment.NewLine

• ControlChars.CrLf

• vbCrLf (solo Visual Basic)

Puede agregar barras de desplazamiento a un cuadro de texto mediante la ScrollBars propiedad para mostrar barras de desplazamiento horizontales o verticales. Esto permite al usuario desplazarse por el texto que se extiende más allá de las dimensiones del control.

Nota

Dado que el valor predeterminado de la Multiline propiedad es false, el tamaño predeterminado de un TextBox objeto se ajustará al tamaño de fuente incluso si cambia el tamaño de .TextBox Para obtener un tamaño coherente para TextBox, establezca su Multiline propiedad en true.

Nota

En los sistemas operativos japoneses, si la Multiline propiedad está establecida trueen , al establecer la PasswordChar propiedad se mostrará el texto de la contraseña, lo que pone en peligro la seguridad del sistema. Por lo tanto, en los sistemas operativos japoneses, establezca la Multiline propiedad false en si establece la PasswordChar propiedad .

Nota

Esta propiedad se establece false en de forma predeterminada para todas las clases derivadas, a excepción del RichTextBox control .

Para un RichTextBox control, la RichTextBox.Multiline propiedad afecta a si el control cambiará automáticamente el tamaño, como se indica a continuación:

• Si RichTextBox.AutoSize se establece true en y RichTextBox.Multiline se establece en true, RichTextBox no cambiará automáticamente el tamaño.

• Si RichTextBox.AutoSize se establece true en y RichTextBox.Multiline se establece en false, RichTextBox cambiará automáticamente el tamaño.

Consulte también

• Lines
• WordWrap
• ScrollBars