RepositoryItemGridLookUpEdit.TextEditStyle Property

Gets or sets a value that specifies whether users can type in the lookup’s text box.

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraGrid.v24.1.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation

Declaration

C#

[DXCategory("Behavior")]
public override TextEditStyles TextEditStyle { get; set; }

VB.NET

<DXCategory("Behavior")>
Public Overrides Property TextEditStyle As TextEditStyles

Property Value

Type	Description
TextEditStyles	A TextEditStyles enumeration value.

Available values:

Name	Description
Standard	A button editor works in its normal way. Editing and selecting text is allowed.
HideTextEditor	The text editing region is not visible and the editor displays only buttons contained in the current button editor. If no buttons can be displayed (for instance because of setting the EditorButton.Visible property to False), the editor displays an empty region in this case.
DisableTextEditor	A button editor is displayed in its normal way. However, editing and selecting text is not allowed. If you want to enable a user to select text but disable text modifications, you can set the text editing style to Standard and set the RepositoryItem.ReadOnly property to true.

Remarks

Set the TextEditStyle property to TextEditStyles.Standard to allow users to type in the text box. Handle the ProcessNewValue event to parse entered values and add new records to the lookup’s data source.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the TextEditStyle 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.

C#

winforms-data-lookups-combobox-mode/CS/Lookup-ComboboxMode/Form1.cs#L56

gridLookUpEdit1.Properties.DataSource = products;
gridLookUpEdit1.Properties.TextEditStyle = DevExpress.XtraEditors.Controls.TextEditStyles.Standard;
gridLookUpEdit1.Properties.AcceptEditorTextAsNewValue = DevExpress.Utils.DefaultBoolean.True;

VB.NET

winforms-data-lookups-combobox-mode/VB/Lookup-ComboboxMode/Form1.vb#L36

gridLookUpEdit1.Properties.DataSource = products
gridLookUpEdit1.Properties.TextEditStyle = DevExpress.XtraEditors.Controls.TextEditStyles.Standard
gridLookUpEdit1.Properties.AcceptEditorTextAsNewValue = DevExpress.Utils.DefaultBoolean.True