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.
<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;