GridOptionsView.RowAutoHeight Property

Gets or sets whether the Data Grid automatically adjusts data row heights depending on cell content.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v18.2.dll

Declaration

C#

[DefaultValue(false)]
[XtraSerializableProperty]
public virtual bool RowAutoHeight { get; set; }

VB.NET

<DefaultValue(False)>
<XtraSerializableProperty>
Public Overridable Property RowAutoHeight As Boolean

Property Value

Type	Default	Description
Boolean	**false**	true to change the data row height automatically; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type	Path to RowAutoHeight
AdvBandedGridView	.OptionsView.RowAutoHeight
BandedGridView	.OptionsView.RowAutoHeight
GridView	.OptionsView.RowAutoHeight

Remarks

When cells display large text values or images, you can enable the RowAutoHeight feature to ensure that the cells display their contents completely.

Note

The row auto height feature is supported when grid cells embed one of the following in-place editors: MemoEdit (RepositoryItemMemoEdit), TokenEdit (RepositoryItemTokenEdit), PictureEdit (RepositoryItemPictureEdit) or HypertextLabel (RepositoryItemHypertextLabel).

If you disable the RowAutoHeight option, all data rows have the same height specified by the View’s GridView.RowHeight property.

Note

Advanced banded grid Views do not support automatic row height calculation, so the RowAutoHeight property is not in effect.

If the RowAutoHeight property is set to true, pixel-based vertical row scrolling is not available, even if the GridOptionsBehavior.AllowPixelScrolling property is forcibly set to True.

The code sample below illustrates how to hide the partially visible row in a grid.

C#

gridView1.OptionsView.RowAutoHeight = true;
gridView1.TopRowChanged += GridView1_TopRowChanged;
gridView1.CustomDrawCell += GridView1_CustomDrawCell;

private bool IsPartiallyVisible(int rowHandle)
{
    return gridView1.IsRowVisible(rowHandle) == RowVisibleState.Partially;
}
private void GridView1_CustomDrawCell(object sender, RowCellCustomDrawEventArgs e)
{
    if (IsPartiallyVisible(e.RowHandle))
    {
        GridCellInfo cellInfo = e.Cell as GridCellInfo;
        cellInfo.Lines.Clear();
        e.Handled = true;
    }
}

private void GridView1_TopRowChanged(object sender, EventArgs e)
{
    gridControl1.Refresh();
}

VB.NET

gridView1.OptionsView.RowAutoHeight = True
AddHandler gridView1.TopRowChanged, AddressOf GridView1_TopRowChanged
AddHandler gridView1.CustomDrawCell, AddressOf GridView1_CustomDrawCell

private Boolean IsPartiallyVisible(Integer rowHandle)
    Return gridView1.IsRowVisible(rowHandle) = RowVisibleState.Partially
private void GridView1_CustomDrawCell(Object sender, RowCellCustomDrawEventArgs e)
    If IsPartiallyVisible(e.RowHandle) Then
        Dim cellInfo As GridCellInfo = TryCast(e.Cell, GridCellInfo)
        cellInfo.Lines.Clear()
        e.Handled = True
    End If

private void GridView1_TopRowChanged(Object sender, EventArgs e)
    gridControl1.Refresh()

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the RowAutoHeight property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-display-rich-text-in-gridviews-cells-but-edit-their-content-in-a-popup-window-e2503/CS/Form1.cs#L47

gridControl1.DataSource = CreateTable(20);
gridView1.OptionsView.RowAutoHeight = false;
gridView1.RowHeight = 30;

how-to-implement-the-autoheight-feature-in-a-custom-editor-e2482/CS/Form1.cs#L120

gridControl1.DataSource = CreateTable();
gridView1.OptionsView.RowAutoHeight = true;
_Ri = new RepositoryItemMyCheckedComboBoxEdit();

custom-editor-how-to-create-a-custom-hyperlinkedit-with-the-autoheight-functionality-e3173/CS/WindowsApplication1/Form1.cs#L25

    gridControl1.DataSource = list;
   gridView1.OptionsView.RowAutoHeight = true;
}

how-to-display-a-formatted-text-in-gridcontrol-e120002/CS/Form1.cs#L35

gridView1.Columns[0].ColumnEdit = ri;
gridView1.OptionsView.RowAutoHeight = true;

how-to-load-images-into-grid-asynchronously-without-using-an-unbound-column-e5208/CS/WindowsFormsApplication1/Form1.cs#L19

gridView1.OptionsView.RowAutoHeight = true;
gridView1.OptionsView.AnimationType = DevExpress.XtraGrid.Views.Base.GridAnimationType.AnimateAllContent;

VB.NET

how-to-display-rich-text-in-gridviews-cells-but-edit-their-content-in-a-popup-window-e2503/VB/Form1.vb#L45

gridControl1.DataSource = CreateTable(20)
gridView1.OptionsView.RowAutoHeight = False
gridView1.RowHeight = 30

how-to-implement-the-autoheight-feature-in-a-custom-editor-e2482/VB/Form1.vb#L111

gridControl1.DataSource = CreateTable()
gridView1.OptionsView.RowAutoHeight = True
_Ri = New RepositoryItemMyCheckedComboBoxEdit()

custom-editor-how-to-create-a-custom-hyperlinkedit-with-the-autoheight-functionality-e3173/VB/WindowsApplication1/Form1.vb#L23

    gridControl1.DataSource = list
   gridView1.OptionsView.RowAutoHeight = True
End Sub

how-to-display-a-formatted-text-in-gridcontrol-e120002/VB/Form1.vb#L34

gridView1.Columns(0).ColumnEdit = ri
gridView1.OptionsView.RowAutoHeight = True

how-to-load-images-into-grid-asynchronously-without-using-an-unbound-column-e5208/VB/WindowsFormsApplication1/Form1.vb#L21

gridView1.OptionsView.RowAutoHeight = True
gridView1.OptionsView.AnimationType = DevExpress.XtraGrid.Views.Base.GridAnimationType.AnimateAllContent