ListView.CurrentObject Property

Specifies a List View’s current object.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v18.2.dll

Declaration

C#

public override object CurrentObject { get; set; }

VB.NET

Public Overrides Property CurrentObject As Object

Property Value

Type	Description
Object	An Object representing the current List View’s current object.

Remarks

The example below demonstrates how to assign a Contact‘s FirstName value to the NickName property via a SimpleAction only in List Views.

C#

using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Actions;
using DevExpress.Persistent.Base;
using MainDemo.Module.BusinessObjects;
// ...
public class SetNickNameController : ViewController<ListView> {
    public SetNickNameController() {
        SimpleAction setNickNameAction = new SimpleAction(this, "SetNickName", PredefinedCategory.Edit);
        setNickNameAction.Execute += SetNickNameAction_Execute;
    }
    private void SetNickNameAction_Execute(object sender, SimpleActionExecuteEventArgs e) {
        Contact currentObject = View.CurrentObject as Contact;
        if(currentObject != null) {
            currentObject.NickName = currentObject.FirstName;
        }
    }
}

VB.NET

Imports DevExpress.ExpressApp
Imports DevExpress.ExpressApp.Actions
Imports DevExpress.Persistent.Base
Imports MainDemo.Module.BusinessObjects

Public Class SetNickNameController
    Inherits ViewController(Of ListView)
    Public Sub New()
        Dim setNickNameAction As New SimpleAction(Me, "SetNickName", PredefinedCategory.Edit)
        AddHandler setNickNameAction.Execute, AddressOf SetNickNameAction_Execute
    End Sub
    Private Sub SetNickNameAction_Execute(ByVal sender As Object, ByVal e As SimpleActionExecuteEventArgs)
        Dim currentObject As Contact = TryCast(View.CurrentObject, Contact)
        If currentObject IsNot Nothing Then
            currentObject.NickName = currentObject.FirstName
        End If
    End Sub
End Class

Use this property to access the focused object of the current List View’s ListView.Editor. If the focused object changes, the View.CurrentObjectChanged event is raised.

When a List View is displayed in the ListViewAndDetailView mode (IModelListView.MasterDetailMode), the object specified by the CurrentObject property is displayed in the accompanying Detail View.

For additional information, refer to the How to: Access Objects Selected in the Current View help topic.

Related GitHub Examples

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

XAF_categorizedlisteditor-how-to-show-subcategory-items-when-a-parent-category-is-selected-e1415/CS/WinSample.Module.Win/MyCategorizedListEditor.cs#L49

if (!locker.Locked) {
    if (CategoriesListView.CurrentObject != null) {
        ArrayList categoryKeys = new ArrayList();

XAF_how-to-access-a-nested-listview-from-the-parent-detailviews-controller-and-vice-versa-e3977/CS/WinExample.Module/Controllers/AccessNestedListViewController.cs#L32

ListView nestedListView = listPropertyEditor.ListView;
UpdateMySimpleAction1Caption((DomainObject2)nestedListView.CurrentObject);
nestedListView.CurrentObjectChanged += new EventHandler(nestedListView_CurrentObjectChanged);

VB.NET

XAF_categorizedlisteditor-how-to-show-subcategory-items-when-a-parent-category-is-selected-e1415/VB/WinSample.Module.Win/MyCategorizedListEditor.vb#L53

If (Not locker.Locked) Then
    If CategoriesListView.CurrentObject IsNot Nothing Then
        Dim categoryKeys As New ArrayList()

XAF_how-to-access-a-nested-listview-from-the-parent-detailviews-controller-and-vice-versa-e3977/VB/WinExample.Module/Controllers/AccessNestedListViewController.vb#L34

Dim nestedListView As ListView = listPropertyEditor.ListView
UpdateMySimpleAction1Caption(CType(nestedListView.CurrentObject, DomainObject2))
AddHandler nestedListView.CurrentObjectChanged, AddressOf nestedListView_CurrentObjectChanged