Skip to main content

ProcessNewValueEventArgs.DisplayValue Property

Gets or sets the value entered by the end-user.

Namespace: DevExpress.XtraEditors.Controls

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

public object DisplayValue { get; set; }

Property Value

Type Description
Object

An object representing the value entered by the end-user.

Remarks

When the end-user enters text within the lookup editor’s edit box that does not match the RepositoryItemLookUpEditBase.DisplayMember field value of any dropdown row, the RepositoryItemLookUpEditBase.ProcessNewValue event is fired. The DisplayValue property specifies the value entered converted to the type of the RepositoryItemLookUpEditBase.DisplayMember field.

If the value entered cannot be converted to this field type, however, then the DisplayValue property will contain the value entered as a string type.

Generally, you use the RepositoryItemLookUpEditBase.ProcessNewValue event in order to add a new row to the dropdown list. When adding a new row, you normally need to set its RepositoryItemLookUpEditBase.DisplayMember field value to DisplayValue. In this case, if you then set the ProcessNewValueEventArgs.Handled property to true, the editor will locate and retrieve the new record after performing your RepositoryItemLookUpEditBase.ProcessNewValue event handler.

The following code snippets (auto-collected from DevExpress Examples) contain references to the DisplayValue property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

See Also