DataGridViewAutoSizeRowMode Enum

  • Reference

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Defines values for specifying how the height of a row is adjusted.

public enum class DataGridViewAutoSizeRowMode
public enum DataGridViewAutoSizeRowMode
type DataGridViewAutoSizeRowMode = 
Public Enum DataGridViewAutoSizeRowMode
Inheritance
Object
ValueType
Enum
DataGridViewAutoSizeRowMode

Fields

Name Value Description
RowHeader 1

The row height adjusts to fit the contents of the row header.
AllCellsExceptHeader 2

The row height adjusts to fit the contents of all cells in the row, excluding the header cell.
AllCells 3

The row height adjusts to fit the contents of all cells in the row, including the header cell.

Examples

The following code example resizes the third row in the control to fit the contents of its nonheader cells. This code example is part of a larger example provided in How to: Programmatically Resize Cells to Fit Content in the Windows Forms DataGridView Control.

void SizeThirdRow( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRow(2, DataGridViewAutoSizeRowMode::AllCellsExceptHeader);
}

private void SizeThirdRow(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeRow(
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader);
}

Private Sub SizeThirdRow(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    Dim thirdRow As Integer = 2
    DataGridView1.AutoResizeRow( _
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader)

End Sub

Remarks

The DataGridView control can resize its rows based on the preferred height of each row. The preferred row height is the minimum height required to display the largest cell value in that row. Different size modes let you indicate which cells are used to calculate the new heights (either header cells or non-header cells) and whether to resize all rows or only the rows that are currently displayed. Resizing a subset of rows is useful to avoid a performance penalty when working with many rows of data.

Content-based automatic resizing prevents users from adjusting row heights with the mouse.

This enumeration is used by the DataGridView control AutoResizeRow method.

For more information about sizing modes, see Sizing Options in the Windows Forms DataGridView Control.

Applies to

See also