Skip to main content
A newer version of this page is available. .

TreeListOptionsClipboard.CopyNodeHierarchy Property

Gets or sets whether selected nodes are copied to the clipboard with or without indents that reflect node hierarchy levels.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v19.2.dll

Declaration

[DefaultValue(DefaultBoolean.Default)]
[XtraSerializableProperty]
public virtual DefaultBoolean CopyNodeHierarchy { get; set; }

Property Value

Type Default Description
DefaultBoolean **Default**

A DefaultBoolean enumerator value that specifies whether the nodes are copied to the clipboard with indents. The Default value is equivalent to True.

Available values:

Name Description
True

Corresponds to a Boolean value of true.

False

Corresponds to a Boolean value of false.

Default

The value is determined by the current object’s parent object setting (e.g., a control setting).

Property Paths

You can access this nested property as listed below:

Library Object Type Path to CopyNodeHierarchy
WinForms Controls GanttControl
.OptionsClipboard.CopyNodeHierarchy
ResourcesTree
.OptionsClipboard.CopyNodeHierarchy
TreeList
.OptionsClipboard.CopyNodeHierarchy
Reporting XRDesignFieldList
.OptionsClipboard.CopyNodeHierarchy
XRDesignReportExplorer
.OptionsClipboard.CopyNodeHierarchy

Remarks

Consider the following Tree List control with five nodes selected.

CopyNodeHierarchy-example-SourceTreeList

When copying the selection as plain text with the CopyNodeHierarchy property set to True or Default, the copied data contains hierarchy indents for each nested node:

CopyNodeHierarchy-example-CopiedDataWithIndents

If the CopyNodeHierarchy property is set to False, no hierarchy indents are included in the output:

CopyNodeHierarchy-example-CopiedDataWithoutIndents

The screenshots above were made in the PlainText copy mode (see ClipboardOptions.ClipboardMode), in which data is copied as plain text and the TAB character is used for node hierarchy indents. In the Formatted copy mode, data is copied in multiple formats simultaneously. Node hierarchy indents are created in different ways for each of these formats.

See Also