TextBoxBase.Multiline Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

TextBoxBase.cs

Ottiene o imposta un valore che indica se si tratta di 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

Nell'esempio di codice seguente viene TextBoxusato , 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 su più righe 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 su più righe consente di visualizzare più righe di testo nel controllo. Se la WordWrap proprietà è impostata su true, il testo immesso nella casella di testo su più righe viene racchiuso nella riga successiva nel controllo . Se la WordWrap proprietà è impostata su false, il testo immesso nel controllo casella di testo su più righe verrà visualizzato nella stessa riga finché non viene immesso un carattere di nuova riga.

I caratteri di nuova riga possono essere usati 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. In questo modo l'utente può scorrere il testo che si estende oltre le dimensioni del controllo.

Annotazioni

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

Annotazioni

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à .

Annotazioni

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 e RichTextBox.Multiline è impostato true su true, RichTextBox non verrà ridimensionato automaticamente.

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

Vedi anche

• Lines
• WordWrap
• ScrollBars