Back to Devexpress

GridOptionsBehavior.AllowPartialRedrawOnScrolling Property

windowsforms-devexpress-dot-xtragrid-dot-views-dot-grid-dot-gridoptionsbehavior-e0cee371.md

latest3.0 KB
Original Source

GridOptionsBehavior.AllowPartialRedrawOnScrolling Property

Gets or sets whether a View repaints only new portions of its surface when a user scrolls through Grid records.

Namespace : DevExpress.XtraGrid.Views.Grid

Assembly : DevExpress.XtraGrid.v25.2.dll

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

Declaration

csharp
[DefaultValue(true)]
[XtraSerializableProperty]
public virtual bool AllowPartialRedrawOnScrolling { get; set; }
vb
<DefaultValue(True)>
<XtraSerializableProperty>
Public Overridable Property AllowPartialRedrawOnScrolling As Boolean

Property Value

TypeDefaultDescription
Booleantrue

true if the View is partially repainted during scrolling; false if the entire region of the View is repainted.

|

Property Paths

You can access this nested property as listed below:

Object TypePath to AllowPartialRedrawOnScrolling
GridView

.OptionsBehavior .AllowPartialRedrawOnScrolling

|

Remarks

To reduce the time required to repaint a View on scrolling, the Grid Control implements the partial redraw mechanism. This is invoked if the AllowPartialRedrawOnScrolling property is set to true. In this instance, the grid only repaints the new section of the View that appears on screen. The rest of the View’s graphic surface is simply shifted depending on the scroll direction.

If the AllowPartialRedrawOnScrolling property is set to false the entire View is repainted when a View is scrolled by a single column or row.

The partial redrawing mechanism is not used in the following instances:

  • if the grid control’s background image is specified via the grid control’s BackgroundImage property;
  • if the cell merging feature (GridOptionsView.AllowCellMerge) is active;

See Also

AllowCellMerge

TopRowIndex

GridOptionsBehavior Class

GridOptionsBehavior Members

DevExpress.XtraGrid.Views.Grid Namespace