Sdílet prostřednictvím

TextBoxBase.Multiline Vlastnost

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Získá nebo nastaví hodnotu určující, zda se jedná o ovládací prvek víceřádkového textového pole.

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

Hodnota vlastnosti

Boolean

trueje-li ovládací prvek víceřádkového textového pole; v opačném případě . false Výchozí formát je false.

Příklady

Následující příklad kódu používá TextBoxodvozenou třídu k vytvoření víceřádkového TextBox ovládacího prvku s svislými posuvníky. Tento příklad také používá AcceptsTab, AcceptsReturna WordWrap vlastnosti k vytvoření víceřádkového textového pole ovládací prvek pro vytváření textových dokumentů.

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

Poznámky

Víceřádkové textové pole umožňuje zobrazit v ovládacím prvku více než jeden řádek textu. WordWrap Pokud je vlastnost nastavena na true, text zadaný do víceřádkového textového pole se zalomí na další řádek ovládacího prvku. WordWrap Pokud je vlastnost nastavena na false, text zadaný do ovládacího prvku víceřádkového textového pole se zobrazí na stejném řádku, dokud se nezadá znak nového řádku.

Jako nové znaky lze použít následující znaky:

Posuvníky můžete přidat do textového ScrollBars pole pomocí vlastnosti k zobrazení vodorovných nebo svislých posuvníků. To umožňuje uživateli procházet text, který přesahuje rozměry ovládacího prvku.

Poznámka

Vzhledem k tomu, že výchozí hodnota Multiline vlastnosti je false, výchozí velikost TextBox a bude v souladu s velikostí písma, i když změníte velikost TextBox. Chcete-li získat konzistentní velikost pro vaši TextBox, nastavte její Multiline vlastnost na true.

Poznámka

V japonských operačních systémech, pokud Multiline je vlastnost nastavena na true, nastavení PasswordChar vlastnosti zobrazí text hesla, čímž dojde k ohrožení zabezpečení systému. Proto v japonských operačních systémech nastavte Multiline vlastnost na hodnotu, pokud false vlastnost nastavíte PasswordChar .

Poznámka

Tato vlastnost je ve výchozím nastavení nastavena false pro všechny odvozené třídy s výjimkou RichTextBox ovládacího prvku.

RichTextBox U ovládacího prvku má RichTextBox.Multiline vlastnost vliv na to, jestli se ovládací prvek automaticky změní na velikost, následujícím způsobem:

Platí pro

Viz také