docs-desktop/dotnet-desktop-guide/framework/wpf/controls/how-to-create-a-multiline-textbox-control.md

title, description, ms.date, helpviewer_keywords, ms.assetid

title	description	ms.date	helpviewer_keywords	ms.assetid
How to: Create a Multiline TextBox Control	Learn how to use XAML to define a TextBox control that expands to accommodate multiple lines of text in a Windows Presentation Foundation application.	03/30/2017	TextBox control [WPF], multiple lines of text	05914a93-d0ea-4a9a-b693-09df7d4e2ac2

How to: Create a Multiline TextBox Control

This example shows how to use Extensible Application Markup Language (XAML) to define a xref:System.Windows.Controls.TextBox control that will automatically expand to accommodate multiple lines of text.

Example

Setting the xref:System.Windows.Controls.TextBox.TextWrapping%2A attribute to Wrap will cause entered text to wrap to a new line when the edge of the xref:System.Windows.Controls.TextBox control is reached, automatically expanding the xref:System.Windows.Controls.TextBox control to include room for a new line, if necessary.

Setting the xref:System.Windows.Controls.Primitives.TextBoxBase.AcceptsReturn%2A attribute to true causes a new line to be inserted when the RETURN key is pressed, once again automatically expanding the xref:System.Windows.Controls.TextBox to include room for a new line, if necessary.

The xref:System.Windows.Controls.Primitives.TextBoxBase.VerticalScrollBarVisibility%2A attribute adds a scroll bar to the xref:System.Windows.Controls.TextBox, so that the contents of the xref:System.Windows.Controls.TextBox can be scrolled through if the xref:System.Windows.Controls.TextBox expands beyond the size of the frame or window that encloses it.

[!code-xamlTextBox_MiscCode#_MultilineTextBoxXAML]

See also

• xref:System.Windows.TextWrapping
• TextBox Overview
• RichTextBox Overview