TextBoxBase.Multiline Proprietà

Definizione

Ottiene o imposta un valore che indica se il controllo in uso è un controllo casella di testo su più righe.Gets or sets a value indicating whether this is a multiline text box control.

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.true if the control is a multiline text box control; otherwise, false. Il valore predefinito è false.The default is false.

Esempio

L'esempio di codice seguente usa TextBox , una classe derivata, per creare un controllo su più righe TextBox con barre di scorrimento verticali.The following code example uses TextBox, a derived class, to create a multiline TextBox control with vertical scroll bars. In questo esempio vengono inoltre utilizzate le AcceptsTab AcceptsReturn proprietà, e WordWrap per rendere il controllo casella di testo su più righe utile per la creazione di documenti di testo.This example also uses the AcceptsTab, AcceptsReturn, and WordWrap properties to make the multiline text box control useful for creating text documents.

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 a più righe consente di visualizzare più di una riga di testo nel controllo.A multiline text box allows you to display more than one line of text in the control. Se la WordWrap proprietà è impostata su true , il testo immesso nella casella di testo su più righe viene sottoposto a incapsulamento nella riga successiva del controllo.If the WordWrap property is set to true, text entered into the multiline text box is wrapped to the next line in the control. Se la WordWrap proprietà è impostata su false , il testo immesso nel controllo casella di testo su più righe verrà visualizzato sulla stessa riga fino a quando non viene immesso un carattere di nuova riga.If the WordWrap property is set to false, text entered into the multiline text box control will be displayed on the same line until a newline character is entered.

Gli elementi seguenti possono essere usati come caratteri di nuova riga:The following can be used as newline characters:

  • Environment.NewLine

  • ControlChars. CrLfControlChars.CrLf

  • vbCrLf (solo Visual Basic)vbCrLf (Visual Basic only)

È possibile aggiungere barre di scorrimento a una casella di testo usando la ScrollBars proprietà per visualizzare le barre di scorrimento orizzontale e/o verticale.You can add scroll bars to a text box using the ScrollBars property to display horizontal and/or vertical scroll bars. Ciò consente all'utente di scorrere il testo che si estende oltre le dimensioni del controllo.This allows the user to scroll through the text that extends beyond the dimensions of the control.

Nota

Poiché il valore predefinito della Multiline proprietà è false , la dimensione predefinita di un oggetto TextBox sarà conforme alle dimensioni del carattere anche se si ridimensiona TextBox .Because the default value of the Multiline property is false, the default size of a TextBox will be in accordance with the font size even if you resize the TextBox. Per ottenere una dimensione coerente per TextBox , impostare la relativa Multiline proprietà su true .To get a consistent size for your TextBox, set its Multiline property to true.

Nota

Nei sistemi operativi giapponesi, se la Multiline proprietà è impostata su true , l'impostazione della proprietà visualizzerà PasswordChar il testo della password, in modo da compromettere la sicurezza del sistema.On Japanese operating systems, if the Multiline property is set to true, setting the PasswordChar property will display the text of the password, thus compromising system security. Nei sistemi operativi giapponesi, quindi, impostare la Multiline proprietà su false se si imposta la PasswordChar Proprietà.Therefore, on Japanese operating systems, set the Multiline property to false if you set the PasswordChar property.

Nota

Questa proprietà è impostata su per false impostazione predefinita per tutte le classi derivate, ad eccezione del RichTextBox controllo.This property is set to false by default for all derived classes, with the exception of the RichTextBox control.

Per un RichTextBox controllo, la RichTextBox.Multiline proprietà influiscono sull'eventuale ridimensionamento automatico del controllo, come indicato di seguito:For a RichTextBox control, the RichTextBox.Multiline property affects whether or not the control will automatically resize, as follows:

Si applica a

Vedi anche