GridOptionsBehavior.AllowPixelScrolling Property

Gets or sets whether smooth pixel-based vertical scrolling is enabled for rows.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v17.2.dll

Declaration

C#

[XtraSerializableProperty]
[DefaultValue(DefaultBoolean.Default)]
public virtual DefaultBoolean AllowPixelScrolling { get; set; }

VB.NET

<XtraSerializableProperty>
<DefaultValue(DefaultBoolean.Default)>
Public Overridable Property AllowPixelScrolling As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	A DefaultBoolean value that specifies whether smooth pixel-based vertical scrolling is enabled for rows.

Available values:

Name	Description
True	Corresponds to a Boolean value of true.
False	Corresponds to a Boolean value of false.
Default	The value is determined by the current object’s parent object setting (e.g., a control setting).

Property Paths

You can access this nested property as listed below:

Object Type	Path to AllowPixelScrolling
GridView	.OptionsBehavior.AllowPixelScrolling

Remarks

If the AllowPixelScrolling property is set to Default or False, pixel scrolling is disabled. If this property is set to True, smooth pixel-based vertical scrolling is enabled for rows.

Note

When pixel scrolling is active:

• Master-Detail Mode is forcibly disabled.
• The GridOptionsBehavior.SmartVertScrollBar property is ignored.

Note

Pixel-based scrolling is not in effect if any of the following features are enabled:

• The row auto height feature (GridOptionsView.RowAutoHeight).
• Preview sections for rows.

Note

If pixel-based scrolling is enabled, take the following into consideration when calculating row height dynamically with the GridView.CalcRowHeight event. You are allowed to provide different heights for different rows with the GridView.CalcRowHeight event. However, the height of every single row must be constant and must not be changed throughout the form run. Otherwise, an end-user may not be able to scroll through all the grid rows.

When pixel scrolling is enabled, you can scroll through rows in code via the GridView.TopRowPixel property and GridView.SmoothScroll methods.

Online Video

DevExpress WinForms: Grid Pixel Scrolling.