Skip to main content
Tab

ASPxGridSettings.HorizontalScrollBarMode Property

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

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.1.dll

NuGet Package: DevExpress.Web

Declaration

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

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.

GridView - FixedColumn

<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:

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

In code:

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

See Also