DataGridView.AutoResizeRows Método

Definición

Ajusta el alto de algunas filas (o todas) para adaptarlas a su contenido.Adjusts the heights of some or all rows to fit their contents.

Sobrecargas

AutoResizeRows(DataGridViewAutoSizeRowsMode)

Ajusta el alto de las filas utilizando el modo de ajuste de tamaño especificado.Adjusts the heights of the rows using the specified size mode value.

AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean)

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

AutoResizeRows()

Ajusta el alto de todas las filas para adaptarlo el contenido de todas sus celdas, incluidas las celdas de encabezado.Adjusts the heights of all rows to fit the contents of all their cells, including the header cells.

AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean)

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

AutoResizeRows(DataGridViewAutoSizeRowsMode)

Ajusta el alto de las filas utilizando el modo de ajuste de tamaño especificado.Adjusts the heights of the rows using the specified size mode value.

public:
 void AutoResizeRows(System::Windows::Forms::DataGridViewAutoSizeRowsMode autoSizeRowsMode);
public void AutoResizeRows (System.Windows.Forms.DataGridViewAutoSizeRowsMode autoSizeRowsMode);
member this.AutoResizeRows : System.Windows.Forms.DataGridViewAutoSizeRowsMode -> unit
Public Sub AutoResizeRows (autoSizeRowsMode As DataGridViewAutoSizeRowsMode)

Parámetros

autoSizeRowsMode
DataGridViewAutoSizeRowsMode

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

Excepciones

autoSizeRowsMode tiene el valor AllHeaders o DisplayedHeaders, y RowHeadersVisible es false.autoSizeRowsMode has the value AllHeaders or DisplayedHeaders, and RowHeadersVisible is false.

autoSizeRowsMode no es un valor DataGridViewAutoSizeRowsMode válido.autoSizeRowsMode is not a valid DataGridViewAutoSizeRowsMode value.

autoSizeRowsMode tiene el valor None.autoSizeRowsMode has the value None.

Ejemplos

En el ejemplo de código siguiente se muestra cómo cambiar el tamaño de todas las filas basándose en el contenido de una celda que no sea de encabezado.The following code example demonstrates how to resize all rows based on non-header cell content. Este ejemplo de código forma parte de un ejemplo más grande proporcionado en [How para: Cambiar mediante programación el tamaño de las celdas para ajustar el contenido en el Windows Forms control DataGridView @ no__t-0.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 SizeAllRows( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRows(DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}

private void SizeAllRows(Object sender,
    EventArgs e)
{
    dataGridView1.AutoResizeRows(
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}
Private Sub SizeAllRows(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button11.Click

    DataGridView1.AutoResizeRows(DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)

End Sub

Comentarios

Este método es útil si desea controlar cuándo se cambia el tamaño de las filas.This method is useful if you want to control when rows resize. El alto de las filas se ajusta solo una vez por cada llamada al método. Si el contenido de las filas cambia posteriormente, las filas no se ajustarán automáticamente.The row heights are adjusted only once per method call; if the contents of the rows later change, the rows will not automatically adjust. Para cambiar el tamaño de una fila concreta, use el método AutoResizeRow.To resize a specific row, use the AutoResizeRow method. Para cambiar el tamaño de un subconjunto de filas, use la sobrecarga AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean).To resize a subset of rows, use the AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) overload. Para establecer que las filas cambien de tamaño automáticamente cada vez que cambie su contenido, use la propiedad AutoSizeRowsMode.To set the rows to automatically resize whenever their contents change, use the AutoSizeRowsMode property.

Para que el contenido de la celda se ajuste en varias líneas cuando se cambia el tamaño de una fila, el estilo de celda en vigor para la celda debe tener un valor de propiedad WrapMode de True.For cell contents to wrap onto multiple lines when a row is resized, the cell style in effect for the cell must have a WrapMode property value of True.

Esta sobrecarga permite especificar un modo de ajuste de tamaño que calcula el nuevo alto 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 heights 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.

Consulte también:

AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean)

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

protected:
 void AutoResizeRows(int rowIndexStart, int rowsCount, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
protected void AutoResizeRows (int rowIndexStart, int rowsCount, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
member this.AutoResizeRows : int * int * System.Windows.Forms.DataGridViewAutoSizeRowMode * bool -> unit
Protected Sub AutoResizeRows (rowIndexStart As Integer, rowsCount As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode, fixedWidth As Boolean)

Parámetros

rowIndexStart
Int32

Índice de la primera fila cuyo tamaño se va a ajustar.The index of the first row to resize.

rowsCount
Int32

Número de filas cuyo tamaño se va a ajustar.The number of rows to resize.

autoSizeRowMode
DataGridViewAutoSizeRowMode

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

fixedWidth
Boolean

Es true para calcular el nuevo alto a partir del ancho actual de las columnas; es false para calcular el alto con la expectativa de que también se ajuste el ancho de las columnas.true to calculate the new heights based on the current column widths; false to calculate the heights with the expectation that the column widths will also be adjusted.

Excepciones

autoSizeRowsMode tiene el valor AllHeaders o DisplayedHeaders, y RowHeadersVisible es false.autoSizeRowsMode has the value AllHeaders or DisplayedHeaders, and RowHeadersVisible is false.

autoSizeRowsMode no es un valor DataGridViewAutoSizeRowsMode válido.autoSizeRowsMode is not a valid DataGridViewAutoSizeRowsMode value.

autoSizeRowsMode tiene el valor None.autoSizeRowsMode has the value None.

rowIndexStart es menor que 0.rowIndexStart is less than 0.

O bien-or- rowsCount es menor que 0.rowsCount is less than 0.

Comentarios

Este método es útil si desea controlar cuándo se cambia el tamaño de las filas, pero solo desea cambiar el tamaño de un subconjunto específico de filas, como los que se encuentran dentro de un intervalo de registros enlazados que se han actualizado.This method is useful if you want to control when rows resize, but you want to resize only a specific subset of rows, such as those within a range of bound records that have been updated. El alto de las filas especificadas solo se ajusta una vez por cada llamada al método. Si el contenido de las filas cambia posteriormente, las filas no se ajustarán automáticamente.The row heights for the specified rows are adjusted only once per method call; if the contents of the rows later change, the rows will not automatically adjust. Para cambiar el tamaño de una fila concreta, use el método AutoResizeRow.To resize a specific row, use the AutoResizeRow method. Para cambiar el tamaño de todas las filas, use una sobrecarga diferente del método AutoResizeRows.To resize all rows, use a different overload of the AutoResizeRows method. Para establecer que las filas cambien de tamaño automáticamente cada vez que cambie su contenido, use la propiedad AutoSizeRowsMode.To set the rows to automatically resize whenever their contents change, use the AutoSizeRowsMode property.

Para que el contenido de la celda se ajuste en varias líneas cuando se cambia el tamaño de una fila, el estilo de celda en vigor para la celda debe tener un valor de propiedad WrapMode de True.For cell contents to wrap onto multiple lines when a row is resized, the cell style in effect for the cell must have a WrapMode property value of True.

Esta sobrecarga permite especificar un modo de ajuste de tamaño que calcula el nuevo alto 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 heights 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 derivada de DataGridView.This overload is protected and is designed to enable you to achieve ideal cell height-to-width ratios in a derived DataGridView class. Si el parámetro fixedWidth es false, el alto de las filas se calculará con la expectativa de que llame al método AutoResizeColumn o AutoResizeColumns siguiente.If the fixedWidth parameter is false, the row heights will be calculated with the expectation that you will call the AutoResizeColumn or AutoResizeColumns 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.

Consulte también:

AutoResizeRows()

Ajusta el alto de todas las filas para adaptarlo el contenido de todas sus celdas, incluidas las celdas de encabezado.Adjusts the heights of all rows to fit the contents of all their cells, including the header cells.

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

Ejemplos

En el ejemplo de código siguiente se muestra cómo cambiar el tamaño de todas las filas basándose en el contenido de una celda que no sea de encabezado.The following code example demonstrates how to resize all rows based on non-header cell content. Este ejemplo de código forma parte de un ejemplo más grande proporcionado en [How para: Cambiar mediante programación el tamaño de las celdas para ajustar el contenido en el Windows Forms control DataGridView @ no__t-0.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 SizeAllRows( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRows(DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}

private void SizeAllRows(Object sender,
    EventArgs e)
{
    dataGridView1.AutoResizeRows(
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}
Private Sub SizeAllRows(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button11.Click

    DataGridView1.AutoResizeRows(DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)

End Sub

Comentarios

Este método es útil si desea controlar cuándo se cambia el tamaño de las filas.This method is useful if you want to control when rows resize. El alto de las filas se ajusta solo una vez por cada llamada al método. Si el contenido de las filas cambia posteriormente, las filas no se ajustarán automáticamente.The row heights are adjusted only once per method call; if the contents of the rows later change, the rows will not automatically adjust. Para cambiar el tamaño de una fila concreta, use el método AutoResizeRow.To resize a specific row, use the AutoResizeRow method. Para cambiar el tamaño de un subconjunto de filas, use la sobrecarga AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean).To resize a subset of rows, use the AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) overload. Para establecer que las filas cambien de tamaño automáticamente cada vez que cambie su contenido, use la propiedad AutoSizeRowsMode.To set the rows to automatically resize whenever their contents change, use the AutoSizeRowsMode property.

Para que el contenido de la celda se ajuste en varias líneas cuando se cambia el tamaño de una fila, el estilo de celda en vigor para la celda debe tener un valor de propiedad WrapMode de True.For cell contents to wrap onto multiple lines when a row is resized, the cell style in effect for the cell must have a WrapMode property value of True.

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.

Consulte también:

AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean)

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

protected:
 void AutoResizeRows(System::Windows::Forms::DataGridViewAutoSizeRowsMode autoSizeRowsMode, bool fixedWidth);
protected void AutoResizeRows (System.Windows.Forms.DataGridViewAutoSizeRowsMode autoSizeRowsMode, bool fixedWidth);
member this.AutoResizeRows : System.Windows.Forms.DataGridViewAutoSizeRowsMode * bool -> unit
Protected Sub AutoResizeRows (autoSizeRowsMode As DataGridViewAutoSizeRowsMode, fixedWidth As Boolean)

Parámetros

autoSizeRowsMode
DataGridViewAutoSizeRowsMode

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

fixedWidth
Boolean

Es true para calcular el nuevo alto a partir del ancho actual de las columnas; es false para calcular el alto con la expectativa de que también se ajuste el ancho de las columnas.true to calculate the new heights based on the current column widths; false to calculate the heights with the expectation that the column widths will also be adjusted.

Excepciones

autoSizeRowsMode tiene el valor AllHeaders o DisplayedHeaders, y RowHeadersVisible es false.autoSizeRowsMode has the value AllHeaders or DisplayedHeaders, and RowHeadersVisible is false.

autoSizeRowsMode no es un valor DataGridViewAutoSizeRowsMode válido.autoSizeRowsMode is not a valid DataGridViewAutoSizeRowsMode value.

autoSizeRowsMode tiene el valor None.autoSizeRowsMode has the value None.

Comentarios

Este método es útil si desea controlar cuándo se cambia el tamaño de las filas.This method is useful if you want to control when rows resize. El alto de las filas se ajusta solo una vez por cada llamada al método. Si el contenido de las filas cambia posteriormente, las filas no se ajustarán automáticamente.The row heights are adjusted only once per method call; if the contents of the rows later change, the rows will not automatically adjust. Para cambiar el tamaño de una fila concreta, use el método AutoResizeRow.To resize a specific row, use the AutoResizeRow method. Para cambiar el tamaño de un subconjunto de filas, use la sobrecarga AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean).To resize a subset of rows, use the AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) overload. Para establecer que las filas cambien de tamaño automáticamente cada vez que cambie su contenido, use la propiedad AutoSizeRowsMode.To set the rows to automatically resize whenever their contents change, use the AutoSizeRowsMode property.

Para que el contenido de la celda se ajuste en varias líneas cuando se cambia el tamaño de una fila, el estilo de celda en vigor para la celda debe tener un valor de propiedad WrapMode de True.For cell contents to wrap onto multiple lines when a row is resized, the cell style in effect for the cell must have a WrapMode property value of True.

Esta sobrecarga permite especificar un modo de ajuste de tamaño que calcula el nuevo alto 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 heights 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 derivada de DataGridView.This overload is protected, and is designed to enable you to achieve ideal cell height-to-width ratios in a derived DataGridView class. Si el parámetro fixedWidth es false, el alto de las filas se calculará con la expectativa de que llame al método AutoResizeColumn o AutoResizeColumns siguiente.If the fixedWidth parameter is false, the row heights will be calculated with the expectation that you will call the AutoResizeColumn or AutoResizeColumns 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.

Consulte también:

Se aplica a