Esta documentación está archivada y no tiene mantenimiento.

DataGridViewAutoSizeColumnMode (Enumeración)

Define los valores para especificar cómo se ajusta el ancho de una columna.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public enum DataGridViewAutoSizeColumnMode
public enum DataGridViewAutoSizeColumnMode
public enum DataGridViewAutoSizeColumnMode

 Nombre de miembroDescripción
AllCellsEl ancho de columna se ajusta para que quepa el contenido de todas las celdas de la columna, incluida la celda de encabezado.  
AllCellsExceptHeaderEl ancho de columna se ajusta para que quepa el contenido de todas las celdas de la columna, excepto la celda de encabezado.  
ColumnHeaderEl ancho de columna se ajusta para que quepa el contenido de la celda de encabezado de columna.  
DisplayedCellsEl 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.  
DisplayedCellsExceptHeaderEl 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.  
FillEl 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 DataGridViewColumn.MinimumWidth. Los valores de la propiedad DataGridViewColumn.FillWeight relativos determinan los anchos de columna relativos. 
NoneEl ancho de columna no se ajusta automáticamente. 
NotSetEl comportamiento de tamaño de la columna se hereda de la propiedad DataGridView.AutoSizeColumnsMode

El control DataGridView puede cambiar el tamaño de sus columnas para hacerles rellenar el ancho horizontal disponible del control o hacerles mostrar el contenido completo de todas las celdas o de determinadas celdas.

Con el modo Fill, el ancho preferido de una columna se determina cambiando el tamaño de todas las columnas que tienen ese modo, para que todas las columnas visibles del control llenen exactamente el ancho horizontal del área de presentación disponible. Con los demás modos, el ancho de columna preferido es el ancho mínimo exigido para mostrar el valor de celda más grande de todas las celdas o un subconjunto de celdas de esa columna, como puede ser el subconjunto de las celdas que forman parte de las filas visibles en un momento dado. Utilizar 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.

El cambio de tamaño automático basado en contenidos evita que los usuarios ajusten el ancho de columna con el mouse. El cambio de tamaño que realiza el usuario sí está permitido en el modo de relleno, sin embargo.

Las propiedades AutoSizeMode y InheritedAutoSizeMode de las columnas y el método System.Windows.Forms.DataGridView.AutoResizeColumn utilizan esta enumeración.

Para obtener más información sobre los modos de tamaño, vea Opciones de ajuste de tamaño en el control DataGridView de formularios Windows Forms. Para obtener más información sobre el modo de relleno de columna en particular, vea Modo de relleno de columnas en el control DataGridView de formularios Windows Forms.

El ejemplo de código siguiente ilustra el uso de esta enumeración para configurar una columna de ancho fijo. Este ejemplo forma parte de un ejemplo más extenso proporcionado en Cómo: Establecer modos de cambio de tamaño para el control DataGridView de formularios Windows Forms.

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

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: