Skip to main content

TcxCustomGridView.Synchronization Property

Determines whether all the “clone“ Views of the current detail View should be synchronized automatically with a “pattern“ View.

Declaration

property Synchronization: Boolean read; write; default True;

Property Value

Type Default
Boolean True

Remarks

Use the Synchronization property to determine whether all the “clone” Views of the current detail View should be synchronized automatically with the “pattern” View. If this property’s value is set to True, all the “clone” Views’ settings are kept synchronized with the “pattern” View, i.e. customizing a clone View’s settings (properties, event handlers) immediately affects the pattern View along with all the existing clones as all “clone” Views will be synchronized with the “pattern” View since the “pattern” View’s settings have been changed. The synchronization process can take a significant amount of time to complete if there are a lot of “clone” Views. Set the detail View’s OptionsBehavior.PostponedSynchronization property to True to improve the performance of the synchronization as in this case only visible “clone” Views will be synchronized.

Note

The Synchronization property is ignored for Views created with the TcxGridViewRepository component. When the Synchronization property is set to True, you should not call the DataController.ClearDetails method to recreate “clone” Views with new “pattern” settings thus keeping all the clones synchronized.

The default value of the Synchronization property is True. You can change this property’s value for detail Views only.

See Also