Export (0) Print
Expand All
Expand Minimize

DataGridViewAutoSizeRowsMode Enumeration

Defines values for specifying how the heights of rows are adjusted.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public enum DataGridViewAutoSizeRowsMode
public enum DataGridViewAutoSizeRowsMode
public enum DataGridViewAutoSizeRowsMode

 Member nameDescription
AllCellsThe row heights adjust to fit the contents of all cells in the rows, including header cells.  
AllCellsExceptHeadersThe row heights adjust to fit the contents of all cells in the rows, excluding header cells.  
AllHeadersThe row heights adjust to fit the contents of the row header.  
DisplayedCellsThe row heights adjust to fit the contents of all cells in rows currently displayed onscreen, including header cells.  
DisplayedCellsExceptHeadersThe row heights adjust to fit the contents of all cells in rows currently displayed onscreen, excluding header cells.  
DisplayedHeadersThe row heights adjust to fit the contents of the row headers currently displayed onscreen. 
NoneThe row heights do not automatically adjust. 

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 nonheader 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 AutoSizeRowsMode property and AutoResizeRows method.

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

The following code example sets rows to automatically resize their height whenever cell contents change. The new row height is determined from the contents of all rows and columns. This code example is part of a larger example provided in How to: Automatically Resize Cells When Content Changes in the Windows Forms DataGridView Control.

private void AutoSizeRowsMode(Object sender, EventArgs es)
{
    dataGridView1.AutoSizeRowsMode =
        DataGridViewAutoSizeRowsMode.AllCells;
}

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show:
© 2014 Microsoft