DataGridViewColumn.AutoSizeMode Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Obtiene o establece el modo mediante el cual la columna ajusta automáticamente su tamaño.

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnMode AutoSizeMode { System::Windows::Forms::DataGridViewAutoSizeColumnMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnMode value); };
public System.Windows.Forms.DataGridViewAutoSizeColumnMode AutoSizeMode { get; set; }
member this.AutoSizeMode : System.Windows.Forms.DataGridViewAutoSizeColumnMode with get, set
Public Property AutoSizeMode As DataGridViewAutoSizeColumnMode

Valor de propiedad

DataGridViewAutoSizeColumnMode

Valor de DataGridViewAutoSizeColumnMode que indica si la columna va a ajustar automáticamente su ancho y cómo va a determinar su ancho preferido. De manera predeterminada, es NotSet.

Excepciones

InvalidEnumArgumentException

El valor especificado al establecer esta propiedad no es un valor válido de DataGridViewAutoSizeColumnMode.

InvalidOperationException

El valor especificado al establecer esta propiedad provoca un valor de InheritedAutoSizeMode igual a ColumnHeader para una columna visible cuando los encabezados de columna están ocultos.

o bien

El valor especificado al establecer esta propiedad provoca un valor de InheritedAutoSizeMode igual a Fill para una columna visible inmovilizada.

Ejemplos

En el ejemplo de código siguiente se fuerza a una columna a cambiar automáticamente el tamaño de su ancho para ajustarse a su contenido. Este ejemplo de código es parte de un ejemplo mayor proporcionado para la clase DataGridViewColumn.

// AutoSize the third column.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   DataGridViewColumn^ column = dataGridView->Columns[ 2 ];
   column->AutoSizeMode = DataGridViewAutoSizeColumnMode::DisplayedCells;
}

// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}

' AutoSize the third column.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim column As DataGridViewColumn = dataGridView.Columns(2)
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
End Sub

Comentarios

El comportamiento de ajuste de tamaño automático de la columna viene determinado por el valor de la InheritedAutoSizeMode propiedad , que es el mismo que el valor de la AutoSizeMode propiedad para todos los valores excepto NotSet, lo que indica que el valor se hereda de la DataGridView.AutoSizeColumnsMode propiedad en su lugar.

Cuando el valor de la InheritedAutoSizeMode propiedad es Fill, la columna se cambia de tamaño junto con otras columnas en ese modo. Todas las columnas en modo de relleno del control dividen el espacio disponible en proporciones determinados por sus FillWeight valores de propiedad. El ancho disponible para el modo de relleno se determina restando los anchos de todas las demás columnas del ancho del área cliente del control. Si este ancho es menor que los valores combinados MinimumWidth de todas las columnas en modo de relleno, se muestra la barra de desplazamiento horizontal, se muestran todas las columnas en modo de relleno con sus anchos mínimos y el cambio de tamaño de columna de usuario está deshabilitado. Para obtener más información sobre el modo de relleno de columnas, vea Modo de relleno de columnas en el control Windows Forms DataGridView.

Cuando la InheritedAutoSizeMode propiedad se establece en cualquier otro valor excepto None, la columna administrará su ancho para que sus valores de celda se muestren completamente sin recortar. En los modos de ajuste de tamaño basados en contenido, los ajustes de tamaño se producen cada vez que cambia el contenido de la celda o, si WrapMode está habilitado, siempre que cambie el alto de fila. Algunos modos de ajuste de tamaño basados en contenido permiten limitar el ajuste de tamaño a las filas mostradas actualmente para aumentar el rendimiento.

Solo se cambia el tamaño de las columnas con un Visible valor de propiedad de true y el cambio de visibilidad de una columna no hace que se produzca el cambio de tamaño. Además, cuando las columnas se establecen para cambiar el tamaño automáticamente, el usuario no puede ajustar los anchos de columna con el mouse.

Para ajustar los anchos de columna mediante programación, use los métodos o del DataGridView control AutoResizeColumn o AutoResizeColumns establezca la propiedad column Width .

Para obtener más información sobre el ajuste de tamaño automático basado en contenido, vea Opciones de ajuste de tamaño en el control dataGridView de Windows Forms.

Se aplica a

Consulte también