BaseView.SynchronizeClones Property

Gets or sets a value specifying whether this View's clones have synchronized appearance and data representation settings.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v20.1.dll

Declaration

[DXCategory("Behavior")]
[DefaultValue(true)]
[XtraSerializableProperty]
public virtual bool SynchronizeClones { get; set; }
<DXCategory("Behavior")>
<DefaultValue(True)>
<XtraSerializableProperty>
Public Overridable Property SynchronizeClones As Boolean

Property Value

Type Default Description
Boolean

true

true to synchronize this View's clones; otherwise, false.

Remarks

Set a pattern View's SynchronizeClones property to true to synchronize its clones.

If the SynchronizeClones property is set to true (the default behavior), all clones corresponding to the same pattern View will be identical. Any operation performed within an opened detail View, and affecting its appearance and data representation will be automatically reflected by other detail Views. Such operations include column resizing, applying data grouping or sorting, etc.

If the SynchronizeClones property value is false, clones corresponding to the same pattern View can have a different appearance and data layout. The image below shows synchronized and independent details. Synchronized details, in contrast to independent, have the same grouping applied.

BaseView_SynchronizeClones.gif

If you want to change a pattern view's SynchronizeClones property value at runtime, bear in mind that you should first collapse all detail Views opened (you can use the GridView.CollapseAllDetails method for this purpose). This is necessary to prevent reverse synchronization occurring between an opened clone and its pattern View.

NOTE

The SynchronizeClones option is only in effect for the Views that are in the GridControl.LevelTree. If a View doesn't belong to the LevelTree, clone synchronization is not supported.

See Also