TextBoxBase.Multiline Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta un valore che indica se il controllo in uso è un controllo casella di testo su più righe.

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.

Nota

Poiché il valore predefinito della proprietà è false, le dimensioni predefinite di Multiline un TextBox oggetto saranno conformi alle dimensioni del tipo di carattere anche se si ridimensiona .TextBox Per ottenere dimensioni coerenti per il TextBox, impostare la relativa Multiline proprietà su true.

Nota

Nei sistemi operativi giapponesi, se la Multiline proprietà è impostata su true, l'impostazione della PasswordChar proprietà visualizzerà il testo della password, compromettendo così la sicurezza del sistema. Pertanto, nei sistemi operativi giapponesi impostare la Multiline proprietà su false se si imposta la PasswordChar proprietà.

Nota

Questa proprietà è impostata su false per impostazione predefinita per tutte le classi derivate, ad eccezione del RichTextBox 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.

Vedi anche

• Lines
• WordWrap
• ScrollBars