TextBoxBase.Multiline Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

TextBoxBase.cs

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

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

truepokud je ovládací prvek víceřádkové textové pole; v opačném případě . false Výchozí hodnota 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 se svislými posuvníky. Tento příklad také používá AcceptsTab, AcceptsReturna WordWrap vlastnosti, aby víceřádkové textové pole ovládací prvek užitečné 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. Pokud je vlastnost nastavena WordWrap na true, text zadaný do víceřádkového textového pole je zabalen na další řádek v ovládacím prvku. Pokud je vlastnost nastavena WordWrap na false, text zadaný do víceřádkového textového pole se zobrazí na stejném řádku, dokud nebude zadán znak nového řádku.

Jako znaky nového řádku je možné použít následující:

• Environment.NewLine

• ControlChars.CrLf

• vbCrLf (jenom Visual Basic)

Posuvníky můžete přidat do textového pole pomocí ScrollBars vlastnosti pro zobrazení vodorovných nebo svislých posuvníků. Uživatel tak může 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 a TextBox 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 jeho 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 false , pokud nastavíte PasswordChar vlastnost.

Poznámka:

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

RichTextBox U ovládacího prvku vlastnost ovlivňuje, RichTextBox.Multiline zda se ovládací prvek automaticky změní, následujícím způsobem:

• Pokud RichTextBox.AutoSize je nastavená hodnota a RichTextBox.Multiline je nastavena na truetrue, RichTextBox nebude automaticky měnit velikost.

• Pokud RichTextBox.AutoSize je nastavená hodnota a RichTextBox.Multiline je nastavená na truefalse, RichTextBox automaticky změní velikost.

Viz také

• Lines
• WordWrap
• ScrollBars