TextBoxBase.Multiline Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera lub ustawia wartość wskazującą, czy jest to kontrolka pola tekstowego wielowierszowego.

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

Wartość właściwości

Boolean

true jeśli kontrolka jest kontrolką wielowierszowego pola tekstowego; w przeciwnym razie , false. Wartość domyślna to false.

Przykłady

W poniższym przykładzie kodu użyto TextBoxklasy pochodnej , aby utworzyć kontrolkę wielowierszową TextBox z pionowymi paskami przewijania. W tym przykładzie użyto AcceptsTabrównież właściwości , AcceptsReturni WordWrap , aby kontrolka wielowierszowego pola tekstowego przydała się do tworzenia dokumentów tekstowych.

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

Uwagi

Wielowierszowe pole tekstowe umożliwia wyświetlanie więcej niż jednego wiersza tekstu w kontrolce. WordWrap Jeśli właściwość jest ustawiona na true, tekst wprowadzony w wielowierszowym polu tekstowym jest opakowany do następnego wiersza w kontrolce. WordWrap Jeśli właściwość jest ustawiona na false, tekst wprowadzony do kontrolki pola tekstowego wielowierszowego będzie wyświetlany w tym samym wierszu do momentu wprowadzenia nowego znaku wiersza.

Następujące elementy mogą być używane jako znaki nowego wiersza:

Paski przewijania można dodać do pola tekstowego, używając ScrollBars właściwości do wyświetlania poziomych i/lub pionowych pasków przewijania. Dzięki temu użytkownik może przewijać tekst, który wykracza poza wymiary kontrolki.

Uwaga

Ponieważ wartość Multiline domyślna właściwości to false, domyślny rozmiar obiektu TextBox będzie zgodny z rozmiarem czcionki, nawet jeśli zmienisz rozmiar TextBox. Aby uzyskać spójny rozmiar dla elementu TextBox, ustaw jego Multiline właściwość na true.

Uwaga

W japońskich systemach operacyjnych, jeśli Multiline właściwość jest ustawiona na true, ustawienie PasswordChar właściwości spowoduje wyświetlenie tekstu hasła, co spowoduje naruszenie zabezpieczeń systemu. W związku z tym w japońskich systemach operacyjnych ustaw Multiline właściwość na false wartość , jeśli właściwość zostanie ustawiona PasswordChar .

Uwaga

Ta właściwość jest domyślnie ustawiona false dla wszystkich klas pochodnych z wyjątkiem kontrolki RichTextBox .

W przypadku kontrolki RichTextBox właściwość ma wpływ na to, RichTextBox.Multiline czy kontrolka zostanie automatycznie zmieniana, w następujący sposób:

Dotyczy

Zobacz też