A newer version of this page is available. Switch to the current version.

TextEdit Class

Represents a text editor.

Namespace: DevExpress.Xpf.Editors

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


public class TextEdit :


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.

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