DataGridViewAutoSizeColumnMode DataGridViewAutoSizeColumnMode DataGridViewAutoSizeColumnMode DataGridViewAutoSizeColumnMode Enum

Definición

Define los valores para especificar cómo se ajusta el ancho de una columna.Defines values for specifying how the width of a column is adjusted.

public enum class DataGridViewAutoSizeColumnMode
public enum DataGridViewAutoSizeColumnMode
type DataGridViewAutoSizeColumnMode = 
Public Enum DataGridViewAutoSizeColumnMode
Herencia
DataGridViewAutoSizeColumnModeDataGridViewAutoSizeColumnModeDataGridViewAutoSizeColumnModeDataGridViewAutoSizeColumnMode

Campos

AllCells AllCells AllCells AllCells 6

El ancho de columna se ajusta para que quepa el contenido de todas las celdas de la columna, incluida la celda de encabezado.The column width adjusts to fit the contents of all cells in the column, including the header cell.

AllCellsExceptHeader AllCellsExceptHeader AllCellsExceptHeader AllCellsExceptHeader 4

El ancho de columna se ajusta para que quepa el contenido de todas las celdas de la columna, excepto la celda de encabezado.The column width adjusts to fit the contents of all cells in the column, excluding the header cell.

ColumnHeader ColumnHeader ColumnHeader ColumnHeader 2

El ancho de columna se ajusta para que quepa el contenido de la celda de encabezado de columna.The column width adjusts to fit the contents of the column header cell.

DisplayedCells DisplayedCells DisplayedCells DisplayedCells 10

El ancho de columna se ajusta para que quepa el contenido de todas las celdas de la columna que pertenecen a filas que están siendo mostradas en pantalla, incluida la celda de encabezado.The column width adjusts to fit the contents of all cells in the column that are in rows currently displayed onscreen, including the header cell.

DisplayedCellsExceptHeader DisplayedCellsExceptHeader DisplayedCellsExceptHeader DisplayedCellsExceptHeader 8

El ancho de columna se ajusta para que quepa el contenido de todas las celdas de la columna que pertenecen a filas que están siendo mostradas en pantalla, excepto la celda de encabezado.The column width adjusts to fit the contents of all cells in the column that are in rows currently displayed onscreen, excluding the header cell.

Fill Fill Fill Fill 16

El ancho de columna ajusta para que los anchos de todas las columnas llenen exactamente el área de presentación del control, obligando únicamente a que el desplazamiento horizontal mantenga los anchos de columna por encima de los valores de la propiedad MinimumWidth.The column width adjusts so that the widths of all columns exactly fills the display area of the control, requiring horizontal scrolling only to keep column widths above the MinimumWidth property values. Los valores de la propiedad FillWeight relativos determinan los anchos de columna relativos.Relative column widths are determined by the relative FillWeight property values.

None None None None 1

El ancho de columna no se ajusta automáticamente.The column width does not automatically adjust.

NotSet NotSet NotSet NotSet 0

El comportamiento de tamaño de la columna se hereda de la propiedad AutoSizeColumnsMode.The sizing behavior of the column is inherited from the AutoSizeColumnsMode property.

Ejemplos

En el ejemplo de código siguiente se muestra el uso de esta enumeración para configurar una columna de ancho fijo.The following code example illustrates the use of this enumeration to configure a fixed-width column. Este ejemplo forma parte de un ejemplo más grande disponible en cómo: Establezca los modos de ajuste de tamaño del controlDataGridView Windows Forms.This example is part of a larger example available in How to: Set the Sizing Modes of the Windows Forms DataGridView Control.

DataGridViewTextBoxColumn idColumn =
    new DataGridViewTextBoxColumn();
idColumn.HeaderText = "ID";
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None;
idColumn.Resizable = DataGridViewTriState.False;
idColumn.ReadOnly = true;
idColumn.Width = 20;
Dim idColumn As New DataGridViewTextBoxColumn()
idColumn.HeaderText = "ID"
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None
idColumn.Resizable = DataGridViewTriState.False
idColumn.ReadOnly = True
idColumn.Width = 20

Comentarios

El DataGridView control puede cambiar el tamaño de las columnas para que rellenen el ancho horizontal disponible del control o para que muestren todo el contenido de todas las celdas o de las celdas especificadas.The 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.

Con el modo de relleno, el ancho preferido de una columna se determina cambiando el tamaño de todas las columnas en ese modo para que todas las columnas visibles del control rellenen exactamente el ancho horizontal del área de presentación disponible.With 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. Con otros modos, el ancho de columna preferido es el ancho mínimo necesario para mostrar el valor de celda más grande de todas las celdas o un subconjunto de celdas de esa columna, como el subconjunto de celdas que están en las filas que se muestran actualmente.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. El uso de un subconjunto de celdas para determinar el nuevo ancho es útil para evitar una reducción del rendimiento al trabajar con muchas filas de datos.Using a subset of cells to determine the new width is useful to avoid a performance penalty when working with many rows of data.

El cambio de tamaño automático basado en el contenido evita que los usuarios ajusten el ancho de las columnas con el mouse.Content-based automatic resizing prevents users from adjusting column widths with the mouse. Sin embargo, el cambio de tamaño de usuario está habilitado en el modo de relleno.User resizing is enabled in fill mode, however.

Esta enumeración la utilizan las AutoSizeMode propiedades InheritedAutoSizeMode y de las columnas y DataGridView.AutoResizeColumn el método.This enumeration is used by the AutoSizeMode and InheritedAutoSizeMode properties of columns and the DataGridView.AutoResizeColumn method.

Para obtener más información sobre los modos de ajuste de tamaño, consulte Opciones de ajuste de tamaño en el control DataGridView Windows Forms.For more information about sizing modes, see Sizing Options in the Windows Forms DataGridView Control. Para obtener más información sobre el modo de relleno de columnas en particular, vea el modo de relleno de columnas en el control DataGridView de Windows Forms.For more information about column fill mode in particular, see Column Fill Mode in the Windows Forms DataGridView Control.

Se aplica a

Consulte también: