CellEditorPresenter.PathMode Property

Specifies whether the CellEditorPresenter.Path property represents an absolute path or a path relative to the parent PropertyDefinition. This is a dependency property.

Namespace: DevExpress.Xpf.PropertyGrid

Assembly: DevExpress.Xpf.PropertyGrid.v19.2.dll

Declaration

C#

public CellEditorPresenterPathMode PathMode { get; set; }

VB.NET

Public Property PathMode As CellEditorPresenterPathMode

Property Value

Type	Description
CellEditorPresenterPathMode	A CellEditorPresenterPathMode enumeration value that specifies whether the CellEditorPresenter.Path property represents a relative path or an absolute path. The default is CellEditorPresenterPathMode.Relative.

Available values:

Name	Description
Absolute	The CellEditorPresenter.Path points to a property of the PropertyGridControl.SelectedObject.
Relative	The CellEditorPresenter.Path points to a property of an object associated with the parent PropertyDefinition.

Remarks

Use the PathMode property to specify whether the CellEditorPresenter.Path property represents a relative path or an absolute path.

Relative path points to a property of an object associated with the parent PropertyDefinition.

Absolute path points to a property of the PropertyGridControl.SelectedObject.

The following example demonstrates the difference between absolute and relative property paths.

XAML

<dxprg:PropertyGridControl SelectedObject="{Binding Person}" ShowProperties="WithPropertyDefinitions">
    <dxprg:PropertyGridControl.PropertyDefinitions>
        <dxprg:PropertyDefinition Path="Address" Header="Contact">
            <dxprg:PropertyDefinition.ContentTemplate>
                <DataTemplate>
                    <StackPanel>
                        <!-- Links to Person.Address.AddressLine1-->
                        <dxprg:CellEditorPresenter Path="AddressLine1"/>
                        <!-- Links to Person.Address.AddressLine2-->
                        <dxprg:CellEditorPresenter Path="AddressLine2"/>
                        <!-- Links to Person.Phone-->
                        <dxprg:CellEditorPresenter Path="Phone" PathMode="Absolute"/>
                    </StackPanel>
                </DataTemplate>
            </dxprg:PropertyDefinition.ContentTemplate>
        </dxprg:PropertyDefinition>
    </dxprg:PropertyGridControl.PropertyDefinitions>
</dxprg:PropertyGridControl>

C#

public class Person {
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public Address Address { get; set; }
    public string Phone { get; set; }
}
public class Address {
    public string AddressLine1 { get; set; }
    public string AddressLine2 { get; set; }
}

C#

public class ViewModel {
    public Person Person { get; set; }
    public ViewModel() {
        Person = new Person {
            FirstName = "Anita",
            LastName = "Benson",
            Address = new Address {
                AddressLine1 = "9602 South Main",
                AddressLine2 = "Seattle, 77025, USA",
            },
            Phone = "7138638137",
        };
    }
}

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the PathMode 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-edit-multiple-property-values-in-a-single-propertygridcontrol-cell-e5077/VB/MainWindow.xaml#L23

    <dxprg:CellEditorPresenter Path="AddressLine2"/>
    <dxprg:CellEditorPresenter Path="Phone" PathMode="Absolute"/>
</StackPanel>