DataGridView.AutoResizeColumns Method

Definition

Ajusta el ancho de todas las columnas para adaptarlo al contenido de sus celdas.Adjusts the width of all columns to fit the contents of their cells.

Overloads

AutoResizeColumns()

Ajusta el ancho de todas las columnas para adaptarlo al contenido de todas sus celdas, incluidas las celdas de encabezado.Adjusts the width of all columns to fit the contents of all their cells, including the header cells.

AutoResizeColumns(DataGridViewAutoSizeColumnsMode)

Ajusta el ancho de todas las columnas utilizando el modo de ajuste de tamaño especificado.Adjusts the width of all columns using the specified size mode.

AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)

Ajusta el ancho de todas las columnas usando el modo de ajuste de tamaño especificado y, opcionalmente, calcula el ancho con la expectativa de que se ajuste a continuación el alto de las filas.Adjusts the width of all columns using the specified size mode, optionally calculating the widths with the expectation that row heights will subsequently be adjusted.

AutoResizeColumns()

Ajusta el ancho de todas las columnas para adaptarlo al contenido de todas sus celdas, incluidas las celdas de encabezado.Adjusts the width of all columns to fit the contents of all their cells, including the header cells.

public:
 void AutoResizeColumns();
public void AutoResizeColumns ();
member this.AutoResizeColumns : unit -> unit
Public Sub AutoResizeColumns ()

Examples

En el siguiente ejemplo de código se cambia el tamaño de todas las columnas para ajustarse al contenido de las columnas y los encabezados de columna.The following code example resizes all columns to fit the contents of the columns and the column headers. Este ejemplo de código forma parte de un ejemplo más grande que se proporciona en Cómo: cambiar mediante programación el tamaño de las celdas para ajustar el contenido en el control DataGridView Windows Forms.This code example is part of a larger example provided in How to: Programmatically Resize Cells to Fit Content in the Windows Forms DataGridView Control.

void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}


private void SizeAllColumns(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeColumns(
        DataGridViewAutoSizeColumnsMode.AllCells);
}
Private Sub SizeAllColumns(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)

End Sub

Remarks

Este método es útil si desea controlar cuándo se cambia el tamaño de las columnas.This method is useful if you want to control when columns resize. Los anchos de columna se ajustan solo una vez por cada llamada al método. Si el contenido de las columnas cambia posteriormente, las columnas no se ajustarán automáticamente.The column widths are adjusted only once per method call; if the contents of the columns later change, the columns will not automatically adjust. Para cambiar el tamaño de una columna concreta, use el método AutoResizeColumn.To resize a specific column, use the AutoResizeColumn method. Para establecer que las columnas cambien de tamaño automáticamente cada vez que cambie su contenido, use la propiedad AutoSizeColumnsMode o la propiedad AutoSizeMode de columna.To set the columns to automatically resize whenever their contents change, use the AutoSizeColumnsMode property or the column AutoSizeMode property.

Para obtener más información sobre el cambio de tamaño mediante programación, consulte Opciones de ajuste de tamaño en el control DataGridView Windows Forms.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

See also

AutoResizeColumns(DataGridViewAutoSizeColumnsMode)

Ajusta el ancho de todas las columnas utilizando el modo de ajuste de tamaño especificado.Adjusts the width of all columns using the specified size mode.

public:
 void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
public void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode -> unit
Public Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode)

Parameters

autoSizeColumnsMode
DataGridViewAutoSizeColumnsMode

Uno de los valores de DataGridViewAutoSizeColumnsMode.One of the DataGridViewAutoSizeColumnsMode values.

Exceptions

autoSizeColumnsMode tiene el valor ColumnHeader y ColumnHeadersVisible es false.autoSizeColumnsMode has the value ColumnHeader and ColumnHeadersVisible is false.

autoSizeColumnsMode tiene el valor None o Fill.autoSizeColumnsMode has the value None or Fill.

autoSizeColumnsMode no es un valor DataGridViewAutoSizeColumnsMode válido.autoSizeColumnsMode is not a valid DataGridViewAutoSizeColumnsMode value.

Examples

En el siguiente ejemplo de código se cambia el tamaño de todas las columnas para ajustarse al contenido de las columnas y los encabezados de columna.The following code example resizes all columns to fit the contents of the columns and the column headers. Este ejemplo de código forma parte de un ejemplo más grande que se proporciona en Cómo: cambiar mediante programación el tamaño de las celdas para ajustar el contenido en el control DataGridView Windows Forms.This code example is part of a larger example provided in How to: Programmatically Resize Cells to Fit Content in the Windows Forms DataGridView Control.

void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}


private void SizeAllColumns(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeColumns(
        DataGridViewAutoSizeColumnsMode.AllCells);
}
Private Sub SizeAllColumns(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)

End Sub

Remarks

Este método es útil si desea controlar cuándo se cambia el tamaño de las columnas.This method is useful if you want to control when columns resize. Los anchos de columna se ajustan solo una vez por cada llamada al método. Si el contenido de las columnas cambia posteriormente, las columnas no se ajustarán automáticamente.The column widths are adjusted only once per method call; if the contents of the columns later change, the columns will not automatically adjust. Para cambiar el tamaño de una columna concreta, use el método AutoResizeColumn.To resize a specific column, use the AutoResizeColumn method. Para establecer que las columnas cambien de tamaño automáticamente cada vez que cambie su contenido, use la propiedad AutoSizeColumnsMode o la propiedad AutoSizeMode de columna.To set the columns to automatically resize whenever their contents change, use the AutoSizeColumnsMode property or the column AutoSizeMode property.

Esta sobrecarga permite especificar un modo de ajuste de tamaño que calcula los nuevos anchos en función de los valores de un conjunto limitado de celdas, como los de las filas mostradas únicamente.This overload lets you specify a sizing mode that calculates the new widths based on values in a limited set of cells, such as those in displayed rows only. Esto mejora el rendimiento cuando el control contiene un gran número de filas.This improves performance when the control contains a large number of rows.

Para obtener más información sobre el cambio de tamaño mediante programación, consulte Opciones de ajuste de tamaño en el control DataGridView Windows Forms.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

See also

AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)

Ajusta el ancho de todas las columnas usando el modo de ajuste de tamaño especificado y, opcionalmente, calcula el ancho con la expectativa de que se ajuste a continuación el alto de las filas.Adjusts the width of all columns using the specified size mode, optionally calculating the widths with the expectation that row heights will subsequently be adjusted.

protected:
 void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
protected void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode * bool -> unit
Protected Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode, fixedHeight As Boolean)

Parameters

autoSizeColumnsMode
DataGridViewAutoSizeColumnsMode

Uno de los valores de DataGridViewAutoSizeColumnsMode.One of the DataGridViewAutoSizeColumnsMode values.

fixedHeight
Boolean

Estrue para calcular los nuevos anchos a partir del alto actual de las filas; es false para calcular los anchos de forma que también se ajuste el alto de las filas.true to calculate the new widths based on the current row heights; false to calculate the widths with the expectation that the row heights will also be adjusted.

Exceptions

autoSizeColumnsMode tiene el valor ColumnHeader y ColumnHeadersVisible es false.autoSizeColumnsMode has the value ColumnHeader and ColumnHeadersVisible is false.

autoSizeColumnsMode tiene el valor None o Fill.autoSizeColumnsMode has the value None or Fill.

autoSizeColumnsMode no es un valor DataGridViewAutoSizeColumnsMode válido.autoSizeColumnsMode is not a valid DataGridViewAutoSizeColumnsMode value.

Remarks

Este método es útil si desea controlar cuándo se cambia el tamaño de las columnas.This method is useful if you want to control when columns resize. Los anchos de columna se ajustan solo una vez por cada llamada al método. Si el contenido de las columnas cambia posteriormente, las columnas no se ajustarán automáticamente.The column widths are adjusted only once per method call; if the contents of the columns later change, the columns will not automatically adjust. Para cambiar el tamaño de una columna concreta, use el método AutoResizeColumn.To resize a specific column, use the AutoResizeColumn method. Para establecer que las columnas cambien de tamaño automáticamente cada vez que cambie su contenido, use la propiedad AutoSizeColumnsMode o la propiedad AutoSizeMode de columna.To set the columns to automatically resize whenever their contents change, use the AutoSizeColumnsMode property or the column AutoSizeMode property.

Esta sobrecarga permite especificar un modo de ajuste de tamaño que calcula los nuevos anchos en función de los valores de un conjunto limitado de celdas, como los de las filas mostradas únicamente.This overload lets you specify a sizing mode that calculates the new widths based on values in a limited set of cells, such as those in displayed rows only. Esto mejora el rendimiento cuando el control contiene un gran número de filas.This improves performance when the control contains a large number of rows.

Esta sobrecarga está protegida y está diseñada para que pueda lograr las relaciones ideales de alto a ancho de celda en una clase DataGridView derivada.This overload is protected and is designed to enable you to achieve ideal cell height-to-width ratios in a derived DataGridView class. Si fixedHeight se false, se calculará el ancho de las columnas con la expectativa de que llame al método AutoResizeRow o AutoResizeRows siguiente.If fixedHeight is false, the column widths will be calculated with the expectation that you will call the AutoResizeRow or AutoResizeRows method next.

Para obtener más información sobre el cambio de tamaño mediante programación, consulte Opciones de ajuste de tamaño en el control DataGridView Windows Forms.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

See also

Applies to