TextEdit Class

Represents a text editor.

Namespace: DevExpress.Xpf.Editors

Assembly: DevExpress.Xpf.Core.v20.1.dll


public class TextEdit :
Public Class TextEdit
    Inherits TextEditBase
    Implements ISupportTextHighlighting


TextEdit Context Menu

The TextEdit represents a single-line text editor by default. To enable multi-line editing, set the TextEditBase.TextWrapping property to Wrap.


The TextEdit class inherits its features from the TextEditBase class.

Refer to the TextEditBase class description for information on derived features and API.

Create a TextEdit

To specify the editor's value, use the BaseEdit.EditValue or TextEditBase.Text property.

<Window ...

<!-- Specify value using the TextEditBase.Text property -->
<dxe:TextEdit Text="Hello World!"/>

<!-- Specify value using the BaseEdit.EditValue property -->
<dxe:TextEdit EditValue="Hello World!"/>

To respond to changing the editor's value, handle the BaseEdit.EditValueChanged event. To check the new value's validity, handle the BaseEdit.Validate event.

Character Casing

If the CharacterCasing property is set to Upper or Lower, the editor's new values will be automatically converted to the corresponding case.

Masked Input

The TextEdit allows you to use masks during editing. To learn more, see Masked Input.

Text Selection

Set the SelectAllOnGotFocus property to true to enable automatic text selection when the editor gets focus via the keyboard. To enable text selection when the editor gets focus via mouse click, set the SelectAllOnMouseUp to true.

To select all the text within the editor manually, use the SelectAll method. To select only the specified amount of text, use the TextEdit.Select(System.Int32,System.Int32) method.

When an end user double-clicks a word in a text edit, the focused word is selected. When an end user clicks 3 times, all the editor's text is selected (that is the same as calling the SelectAll method).

Spin Input

The TextEdit.SpinUp method is in effect if the editor's TextEdit.MaskType property is set to MaskType.Numeric or MaskType.DateTime.

An end user can increment the editor's value by scrolling up the mouse wheel or by pressing the UP key. If the editor's TextEdit.MaskType property is set to MaskType.DateTime, the TextEdit.SpinUp method increments a component of the date where the caret is located.

To decrement the editor's value, use the TextEdit.SpinDown method. Calling the TextEdit.SpinUp or TextEdit.SpinDown method fires the TextEdit.Spin event.

In-Place TextEdit

To embed a TextEdit into a container control, use the TextEditSettings class.

See Also