System.Windows.Forms.DataGridViewAutoSizeColumnsMode Enumeration

Defines values for specifying how the widths of columns are adjusted.

Syntax

public enum DataGridViewAutoSizeColumnsMode

Remarks

The System.Windows.Forms.DataGridView control can resize its columns to make them fill the available horizontal width of the control or to make them display the full contents of all cells or of specified cells.

With DataGridViewAutoSizeColumnMode.Fill mode, the preferred width of a column is determined by resizing all columns in that mode so that all visible columns in the control exactly fill the horizontal width of the available display area. With other modes, the preferred column width is the minimum width required to display the largest cell value from all cells or a subset of cells in that column, such as the subset of cells that are in currently displayed rows. Using a subset of cells to determine the new width is useful to avoid a performance penalty when working with many rows of data.

Content-based automatic resizing prevents users from adjusting column widths with the mouse. User resizing is enabled in fill mode, however.

This enumeration is used by the System.Windows.Forms.DataGridView control DataGridView.AutoSizeColumnsMode property and erload:System.Windows.Forms.DataGridView.AutoResizeColumns method.

For more information about sizing modes, see Sizing Options in the Windows Forms DataGridView Control. For more information about column fill mode in particular, see Column Fill Mode in the Windows Forms DataGridView Control.

Members

Member NameDescription
AllCells

The column widths adjust to fit the contents of all cells in the columns, including header cells.

AllCellsExceptHeader

The column widths adjust to fit the contents of all cells in the columns, excluding header cells.

ColumnHeader

The column widths adjust to fit the contents of the column header cells.

DisplayedCells

The column widths adjust to fit the contents of all cells in the columns that are in rows currently displayed onscreen, including header cells.

DisplayedCellsExceptHeader

The column widths adjust to fit the contents of all cells in the columns that are in rows currently displayed onscreen, excluding header cells.

Fill

The column widths adjust so that the widths of all columns exactly fill the display area of the control, requiring horizontal scrolling only to keep column widths above the DataGridViewColumn.MinimumWidth property values. Relative column widths are determined by the relative DataGridViewColumn.FillWeight property values.

None

The column widths do not automatically adjust.

Requirements

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0