Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

GridSplitContainer.SynchronizeScrolling Property

Gets or sets whether scrolling positions are in sync between two grid controls. This property is not in effect when the Grid Control presents data using a CardView or LayoutView object.

Namespace: DevExpress.XtraGrid

Assembly: DevExpress.XtraGrid.v24.2.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation

#Declaration

[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Split")]
public DefaultBoolean SynchronizeScrolling { get; set; }

#Property Value

Type Default Description
DefaultBoolean Default

A DefaultBoolean value that specifies if scrolling positions are in sync between two grid controls.

Available values:

Name Description Return Value
True

The value is true.

0

False

The value is false.

1

Default

The value is specified by a global option or a higher-level object.

2

#Remarks

If the SynchronizeScrolling property is set to Default, the horizontal scrolling positions are synchronized when the grid is divided by a horizontal splitter (see GridSplitContainer.Horizontal); and the vertical scrolling positions are synchronized when the grid is divided by a vertical splitter.

If the SynchronizeScrolling property is set to Default or True, certain grid properties are automatically adjusted when the grid control is split. When it is split vertically, the column headers are automatically made visible and horizontal scrolling is disabled. If you do not need this behavior, you can restore the previous settings via the GridOptionsView.ShowColumnHeaders and GridView.HorzScrollVisibility options after the grid is split. When the grid is split horizontally, the vertical scrolling is disabled via the GridView.VertScrollVisibility option. If required, you can enable vertical scrolling using this property after the grid is split.

See Also