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

DataGridViewAutoSizeColumnsMode (Enumeración)

Define los valores para especificar cómo se ajustan los anchos de las columnas.

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

public enum DataGridViewAutoSizeColumnsMode
public enum DataGridViewAutoSizeColumnsMode
public enum DataGridViewAutoSizeColumnsMode

 Nombre de miembroDescripción
AllCellsLos anchos de columna se ajustan para adaptarse al contenido de todas las celdas de las columnas, incluidas las celdas de encabezado.  
AllCellsExceptHeaderLos anchos de columna se ajustan para adaptarse al contenido de todas las celdas de las columnas, sin incluir las celdas de encabezado.  
ColumnHeaderLos anchos de columna se ajustan para adaptarse al contenido de las celdas de encabezado de columna.  
DisplayedCellsLos anchos de columna se ajustan para adaptarse al contenido de todas las celdas de las columnas que están en filas mostradas actualmente en la pantalla, incluidas las celdas de encabezado.  
DisplayedCellsExceptHeaderLos anchos de columna se ajustan para adaptarse al contenido de todas las celdas de las columnas que están en filas mostradas actualmente en la pantalla, sin incluir las celdas de encabezado.  
FillLos anchos de columna se ajustan para que los anchos de todas las columnas rellenen exactamente el área de presentación del control, por lo que sólo se requiere desplazamiento horizontal para mantener 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. 
NoneLos anchos de columna no se ajustan automáticamente.  

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

Con el modo Fill, 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 ocupen exactamente el ancho horizontal del área de presentación disponible. 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 de un subconjunto de celdas de esa columna, como el subconjunto de celdas que están en filas mostradas actualmente. Utilizar un subconjunto de celdas para determinar el nuevo ancho es útil para evitar la reducción del rendimiento al trabajar con muchas filas de datos.

El cambio de tamaño automático basado en el contenido impide a los usuarios ajustar el ancho de las columnas con el mouse. Sin embargo, el cambio de tamaño por el usuario está habilitado en el modo de relleno.

El control DataGridView, la propiedad AutoSizeColumnsMode y el método AutoResizeColumns 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 columnas 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 en un escenario de patrón/detalles en el que dos controles DataGridView muestran datos de dos tablas en una relación primaria-secundaria. En este ejemplo, el modo de cambio de tamaño de columna del el control principal es None y los ancho de columna se inicializan mediante programación para ajustar los valores cargados. El control de detalles está establecido en un modo de tamaño automático para que las columnas se ajusten automáticamente cada vez que cambien los valores (por ejemplo, cuando el usuario cambia la fila actual en la tabla primaria). Este ejemplo forma parte de un ejemplo más extenso proporcionado en Cómo: Crear un formulario principal-detalle mediante dos controles DataGridView de formularios Windows Forms.

private void Form1_Load(object sender, System.EventArgs e)
{
    // Bind the DataGridView controls to the BindingSource
    // components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource;
    detailsDataGridView.DataSource = detailsBindingSource;
    GetData();

    // Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns();

    // Configure the details DataGridView so that its columns automatically
    // adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = 
        DataGridViewAutoSizeColumnsMode.AllCells;
}

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: