DiagramCustomGetEditableItemPropertiesEventArgs.CreateProxyProperty(PropertyDescriptor, Func<IDiagramItem, Object>, IEnumerable<Attribute>) Method

Allows you to create a custom property descriptor.

Namespace: DevExpress.Xpf.Diagram

Assembly: DevExpress.Xpf.Diagram.v24.1.dll

NuGet Package: DevExpress.Wpf.Diagram

Declaration

C#

public PropertyDescriptor CreateProxyProperty(
    PropertyDescriptor property,
    Func<IDiagramItem, object> getObject,
    IEnumerable<Attribute> additionalAttributes = null
)

VB.NET

Public Function CreateProxyProperty(
    property As PropertyDescriptor,
    getObject As Func(Of IDiagramItem, Object),
    additionalAttributes As IEnumerable(Of Attribute) = Nothing
) As PropertyDescriptor

Parameters

Name	Type
property	PropertyDescriptor
getObject	Func<DevExpress.Diagram.Core.IDiagramItem, Object>

Optional Parameters

Name	Type	Default	Description
additionalAttributes	IEnumerable<Attribute>	null	A collection of property attributes.

Returns

Type	Description
PropertyDescriptor	The property descriptor that can be added to the Properties collection.

Remarks

Use the CreateProxyProperty method to allow users to edit properties that are not defined directly at the diagram item level. This can be useful when your diagram is bound to a data source and you need to edit data item properties.

See the example below.

C#

 private void DiagramDesignerControl_CustomGetEditableItemProperties(object sender,
        DevExpress.Xpf.Diagram.DiagramCustomGetEditableItemPropertiesEventArgs e) {
    if (e.Item is DiagramShape)
    {
        PropertyDescriptor namePropertyDescriptor = e.CreateProxyProperty("Name", item => ((Customer)item.DataContext).Name, (item, value) => ((Customer)item.DataContext).Name = value);
        e.Properties.Add(namePropertyDescriptor);
    }
}

VB.NET

 Private Sub DiagramDesignerControl_CustomGetEditableItemProperties(ByVal sender As Object,
        ByVal e As DevExpress.Xpf.Diagram.DiagramCustomGetEditableItemPropertiesEventArgs)
    If TypeOf e.Item Is DiagramShape Then
        Dim namePropertyDescriptor As PropertyDescriptor = e.CreateProxyProperty(Of String)
            ("Name", New Func(Of IDiagramItem, String)(AddressOf GetNameFromItem), New Action(Of IDiagramItem, String)(AddressOf SetItemName))
        e.Properties.Add(namePropertyDescriptor)
    End If
End Sub
Public Function GetNameFromItem(ByVal item As IDiagramItem) As String
    Return (CType(item.DataContext, Customer)).Name
End Function
Public Sub SetItemName(ByVal item As IDiagramItem, ByVal value As String)
    CType(item.DataContext, Customer).Name = value
End Sub