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.v19.2.dll

Declaration

C#

[DefaultValue(true)]
[XtraSerializableProperty]
public virtual bool AllowPartialRedrawOnScrolling { get; set; }

VB.NET

<DefaultValue(True)>
<XtraSerializableProperty>
Public Overridable Property AllowPartialRedrawOnScrolling As Boolean

Property Value

Type	Default	Description
Boolean	**true**	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 Type	Path 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 AppearanceObject.BackColor2 property of the GridViewAppearances.Empty object is set to a valid color;
• 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;