GridLookUpEdit.Properties Property

Specifies settings specific to the current editor.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraGrid.v19.2.dll

Declaration

C#

[DXCategory("Properties")]
public RepositoryItemGridLookUpEdit Properties { get; }

VB.NET

<DXCategory("Properties")>
Public ReadOnly Property Properties As RepositoryItemGridLookUpEdit

Property Value

Type	Description
RepositoryItemGridLookUpEdit	A RepositoryItemGridLookUpEdit object containing settings for the editor.

Remarks

Use the Properties object to customize the lookup editor. You can use its members to specify:

• the source of the dropdown rows (RepositoryItemLookUpEditBase.DataSource);
• the field whose data is displayed in the edit box (RepositoryItemLookUpEditBase.DisplayMember);
• the field which matches the edit value (RepositoryItemLookUpEditBase.ValueMember);
• the type of View to represent data in the dropdown (RepositoryItemGridLookUpEditBase.PopupViewType), etc.

When using editors for inplace editing within container controls such as the XtraGrid, you do not work with the editors directly but work with corresponding repository items. In order to use a lookup editor for inplace editing, you have to create a RepositoryItemGridLookUpEdit object explicitly (for instance via the grid’s designer) and then assign it to a specific column. A lookup editor will be automatically created when required based upon the repository item settings.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Properties 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#

how-to-use-typeconverter-for-converting-values-displayed-in-a-gridlookupedit-dropdown-e2814/CS/E2814/WindowsApplication3/Main.cs#L59

SetUpEditor(edit);
SetUpEditor(gridLookUpEdit1.Properties);

gridlookupedit-how-to-find-an-item-which-equals-the-entered-one-in-textbox-e5211/CS/WinFormsApp/CustomGridLookUpEdit.cs#L38

{
    get { return base.Properties as RepositoryItemCustomridLookUpEdit; }
}

how-to-make-gridlookupedit-set-its-editvalue-to-null-when-its-text-is-an-empty-string-e2786/CS/CustomEditorWinApp4/CustomLookUpEdit.cs#L23

{
    return base.Properties as RepositoryItemCustomGridLookUpEdit;
}

gridlookupedit-how-to-filter-data-in-all-visible-columns-using-the-contains-condition-e1985/CS/GridLookUpEdit_MultiAutoSearch/CustomGridLookUpEdit.cs#L55

    [DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
    public new RepositoryItemCustomGridLookUpEdit Properties { get { return base.Properties as RepositoryItemCustomGridLookUpEdit; } }
}

gridlookupedit-multiple-selection-web-style-with-the-ok-cancel-buttons-e4048/CS/GridLookUpEditCBMultipleSelection/GridLookUpExtention.cs#L138

{
    get { return base.Properties as MyRepositoryItemGridLookUpEdit; }
}

VB.NET

how-to-use-typeconverter-for-converting-values-displayed-in-a-gridlookupedit-dropdown-e2814/VB/WindowsApplication3/Main.vb#L62

SetUpEditor(edit)
SetUpEditor(gridLookUpEdit1.Properties)

gridlookupedit-how-to-find-an-item-which-equals-the-entered-one-in-textbox-e5211/VB/WinFormsApp/CustomGridLookUpEdit.vb#L38

Get
    Return TryCast(MyBase.Properties, RepositoryItemCustomridLookUpEdit)
End Get

how-to-make-gridlookupedit-set-its-editvalue-to-null-when-its-text-is-an-empty-string-e2786/VB/CustomEditorWinApp4/CustomLookUpEdit.vb#L19

Get
    Return TryCast(MyBase.Properties, RepositoryItemCustomGridLookUpEdit)
End Get

gridlookupedit-how-to-filter-data-in-all-visible-columns-using-the-contains-condition-e1985/VB/GridLookUpEdit_MultiAutoSearch/CustomGridLookUpEdit.vb#L80

Get
    Return TryCast(MyBase.Properties, RepositoryItemCustomGridLookUpEdit)
End Get

gridlookupedit-multiple-selection-web-style-with-the-ok-cancel-buttons-e4048/VB/GridLookUpEditCBMultipleSelection/GridLookUpExtention.vb#L133

Get
    Return TryCast(MyBase.Properties, MyRepositoryItemGridLookUpEdit)
End Get