ASPxGridSettings.HorizontalScrollBarMode Property

Gets or sets a value specifying the horizontal scrollbar’s display mode.

Assembly : DevExpress.Web.v25.2.dll

Declaration

C#
VB.NET

csharp

[DefaultValue(ScrollBarMode.Hidden)]
public ScrollBarMode HorizontalScrollBarMode { get; set; }

<DefaultValue(ScrollBarMode.Hidden)>
Public Property HorizontalScrollBarMode As ScrollBarMode

Property Value

Type	Default	Description
ScrollBarMode	Hidden

One of the ScrollBarMode enumeration values.

Available values:

Name	Description
Hidden

The scrollbar is hidden.

| | Visible |

The scrollbar is visible.

| | Auto |

The scrollbar is automatically shown when the size of the control content exceeds the size of the control itself.

Remarks

Use the HorizontalScrollBarMode property to control the visibility of the horizontal scroll bar in the control.

The vertical scrollbar display mode can be specified by the ASPxGridSettings.VerticalScrollBarMode property.

Note

When you enable horizontal scrolling, you should specify the width of the Grid View and each of its columns. If you do not specify the width of a column, the Grid View sets the column’s width to 100 pixels.
You cannot change the HorizontalScrollBarMode and ASPxGridSettings.VerticalScrollBarMode properties values on callback.
When the grid uses the horizontal scrollbar, end-users cannot switch pages using swipe gestures (the ASPxGridBase.EnablePagingGestures property is not in effect).

When the horizontal scrolling is enabled, you can use the FixedStyle property to fix columns to the left edge.

ASPX

aspx

<dx:ASPxGridView ID="Grid" >
    <Columns>
        <dx:GridViewDataColumn FieldName="ContactName" Width="150" FixedStyle="Left" />
        <dx:GridViewDataColumn FieldName="CompanyName" Width="180" FixedStyle="Left" />
        <dx:GridViewDataColumn FieldName="City" Width="130" />
        ...
    </Columns>
    <Settings HorizontalScrollBarMode="Visible" />
    <Styles>
        <FixedColumn BackColor="LightYellow" />
    </Styles>
</dx:ASPxGridView>

Example

In markup:

ASPX

aspx

<dx:ASPxGridView ID="Grid" >
    <Columns>
        ...
    </Columns>
    <Settings HorizontalScrollBarMode="Visible" VerticalScrollBarMode="Visible" />
</dx:ASPxGridView>

In code:

csharp

ASPxGridView grid1 = new ASPxGridView();
grid1.ID = "grid1";
Page.Form.Controls.Add(grid1);
...
grid1.Settings.HorizontalScrollBarMode = ScrollBarMode.Visible;
grid1.Settings.VerticalScrollBarMode = ScrollBarMode.Visible;

Concept

Online Demo

ASPxGridView - Scrolling