TextBoxBase.Multiline Proprietà

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

Valore della proprietà

Boolean

true se il controllo è un controllo casella di testo su più righe; in caso contrario, false. Il valore predefinito è false.

Esempio

L'esempio di codice seguente usa TextBox, una classe derivata, per creare un controllo multilinea TextBox con barre di scorrimento verticali. In questo esempio vengono usate anche le AcceptsTabproprietà , AcceptsReturne WordWrap per rendere utile il controllo casella di testo multilinea per la creazione di documenti di testo.

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

Commenti

Una casella di testo multilinea consente di visualizzare più righe di testo nel controllo. Se la WordWrap proprietà è impostata su true, il testo immesso nella casella di testo multilinea viene eseguito il wrapping alla riga successiva nel controllo. Se la WordWrap proprietà è impostata su false, il testo immesso nel controllo casella di testo multilinea verrà visualizzato nella stessa riga finché non viene immesso un carattere di nuova riga.

È possibile usare quanto segue come caratteri di nuova riga:

• Environment.NewLine

• ControlChars.CrLf

• vbCrLf (solo Visual Basic)

È possibile aggiungere barre di scorrimento a una casella di testo usando la ScrollBars proprietà per visualizzare barre di scorrimento orizzontali e/o verticali. Ciò consente all'utente di scorrere il testo che si estende oltre le dimensioni del controllo.

Per un RichTextBox controllo, la RichTextBox.Multiline proprietà influisce sul fatto che il controllo venga ridimensionato automaticamente, come indicato di seguito:

• Se RichTextBox.AutoSize è impostato su true e RichTextBox.Multiline viene impostato su true, RichTextBox non verrà ridimensionato automaticamente.

• Se RichTextBox.AutoSize è impostato su true e RichTextBox.Multiline viene impostato su false, RichTextBox verrà ridimensionato automaticamente.

Si applica a

Vedi anche

• Lines
• WordWrap
• ScrollBars