ComplexWebListEditor.FindPropertyEditor(String, ViewEditMode) Method

Provides access to the ComplexWebListEditor‘s Property Editor, representing a particular property.

Namespace: DevExpress.ExpressApp.Web.Editors

Assembly: DevExpress.ExpressApp.Web.v24.2.dll

NuGet Package: DevExpress.ExpressApp.Web

Declaration

C#

public WebPropertyEditor FindPropertyEditor(
    string propertyName,
    ViewEditMode viewEditMode
)

VB.NET

Public Function FindPropertyEditor(
    propertyName As String,
    viewEditMode As ViewEditMode
) As WebPropertyEditor

Parameters

Name	Type	Description
propertyName	String	A string holding the name of the required property.
viewEditMode	ViewEditMode	A ViewEditMode enumeration value that specify the display mode.

Returns

Type	Description
WebPropertyEditor	A WebPropertyEditor representing the specified property.

Remarks

To create inline templates used to display grid cells, the ComplexWebListEditor instantiates appropriate Property Editors, using the information from the Application Model. The FindPropertyEditor method allows you to customize the actual controls representing grid cells, by customizing these Property Editors. The following code snippet illustrates this. The MyViewController designed for Contact List Views, changes the display color of the LastName property to purple.

C#

using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Editors;
using DevExpress.ExpressApp.Model;
using DevExpress.ExpressApp.Web.Editors;

public class MyViewController : ObjectViewController<ListView, Contact> {
    WebPropertyEditor lastNamePropertyEditor;
    protected override void OnViewControlsCreated() {
        base.OnViewControlsCreated();
        if (View.Editor is ComplexWebListEditor) {
            IModelMemberViewItem lastName = View.Model.Columns["LastName"];
            lastNamePropertyEditor = ((ComplexWebListEditor)View.Editor).FindPropertyEditor(lastName, ViewEditMode.View);
            lastNamePropertyEditor.ControlCreated += MyViewController_ControlCreated;
        }
    }
    void MyViewController_ControlCreated(object sender, EventArgs e) {
        ((WebPropertyEditor)sender).InplaceViewModeEditor.ForeColor = Color.Purple;
    }
    protected override void OnDeactivated() {
        base.OnDeactivated();
        if (lastNamePropertyEditor != null) {
            lastNamePropertyEditor.ControlCreated -= MyViewController_ControlCreated;
            lastNamePropertyEditor = null;
        }
    }
}

VB.NET

Imports DevExpress.ExpressApp
Imports DevExpress.ExpressApp.Editors
Imports DevExpress.ExpressApp.Model
Imports DevExpress.ExpressApp.Web.Editors

Public Class MyViewController
    Inherits ObjectViewController(Of ListView, Contact)

    Private lastNamePropertyEditor As WebPropertyEditor
    Protected Overrides Sub OnViewControlsCreated()
        MyBase.OnViewControlsCreated()
        If TypeOf View.Editor Is ComplexWebListEditor Then
            Dim lastName As IModelMemberViewItem = View.Model.Columns("LastName")
            lastNamePropertyEditor = CType(View.Editor, ComplexWebListEditor).FindPropertyEditor(lastName, ViewEditMode.View)
            AddHandler lastNamePropertyEditor.ControlCreated, AddressOf MyViewController_ControlCreated
        End If
    End Sub
    Private Sub MyViewController_ControlCreated(ByVal sender As Object, ByVal e As EventArgs)
        CType(sender, WebPropertyEditor).InplaceViewModeEditor.ForeColor = Color.Purple
    End Sub
    Protected Overrides Sub OnDeactivated()
        MyBase.OnDeactivated()
        If lastNamePropertyEditor IsNot Nothing Then
            RemoveHandler lastNamePropertyEditor.ControlCreated, AddressOf MyViewController_ControlCreated
            lastNamePropertyEditor = Nothing
        End If
    End Sub
End Class