TextBox.MaxLines Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets the maximum number of visible lines.

Namespace:   System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

public int MaxLines { get; set; }

Property Value

Type: System.Int32

The maximum number of visible lines. The default is Int32.MaxValue.

Exception Condition

MaxLines is less than MinLines.

Getting this property returns the current value of MaxLines. Setting this property causes the text box to resize if the number of visible lines exceeds the limit specified by MaxLines.

This property applies only to visible lines, and does not constrain the actual number of lines. Depending on its configuration, a text box may contain additional non-visible lines that are accessible by scrolling.

If the Height property is explicitly set on a TextBox, the MaxLines and MinLines property values are ignored.

Identifier field


Metadata properties set to true


The following example shows how to create a TextBox with a MaxLines value of 5.

<Page  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      Text="Initial text in TextBox" 
      MaxLines="5" />
StackPanel myStackPanel = new StackPanel();

//Create TextBox
TextBox myTextBox = new TextBox();
myTextBox.Width = 200;

// Put some initial text in the TextBox.
myTextBox.Text = "Initial text in TextBox";

// Set the maximum characters a user can manually type
// into the TextBox.
myTextBox.MaxLength = 500;
myTextBox.MinLines = 1;

// Set the maximum number of lines the TextBox will expand to 
// accomidate text. Note: This does not constrain the amount of 
// text that can be typed. To do that, use the MaxLength property.
myTextBox.MaxLines = 5;

// The text typed into the box is aligned in the center.
myTextBox.TextAlignment = TextAlignment.Center;

// When the text reaches the edge of the box, go to the next line.
myTextBox.TextWrapping = TextWrapping.Wrap;

this.Content = myStackPanel;

.NET Framework
Available since 3.0
Return to top