This documentation is archived and is not being maintained.

TextBox.MaxLines Property

Gets or sets the maximum number of visible lines.

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

public int MaxLines { get; set; }
<object MaxLines="int" .../>

Property Value

Type: System.Int32
The maximum number of visible lines. The default is Int32.MaxValue.

Identifier field


Metadata properties set to true



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.

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

<Page  xmlns=""
      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

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.