DataGridView.AutoResizeRows Método

Definición

Ajusta el alto de algunas filas (o todas) para adaptarlas a su contenido.

Sobrecargas

AutoResizeRows(DataGridViewAutoSizeRowsMode)

Ajusta el alto de las filas utilizando el modo de ajuste de tamaño especificado.

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.

AutoResizeRows()

Ajusta el alto de todas las filas para adaptarlo al contenido de todas sus celdas, incluidas las celdas de encabezado.

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.

AutoResizeRows(DataGridViewAutoSizeRowsMode)

Ajusta el alto de las filas utilizando el modo de ajuste de tamaño especificado.

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.

Excepciones

autoSizeRowsMode tiene el valor AllHeaders o DisplayedHeaders, y RowHeadersVisible es false.

autoSizeRowsMode no es un valor DataGridViewAutoSizeRowsMode válido.

autoSizeRowsMode tiene el valor None.

Ejemplos

En el ejemplo de código siguiente se muestra cómo cambiar el tamaño de todas las filas en función del contenido de celdas que no son de encabezado. Este ejemplo de código forma parte de un ejemplo más grande proporcionado en 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. Las alturas de fila se ajustan una sola vez por llamada al método; Si el contenido de las filas cambia más adelante, las filas no se ajustarán automáticamente. Para cambiar el tamaño de una fila específica, use el AutoResizeRow método . Para cambiar el tamaño de un subconjunto de filas, use la AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) sobrecarga . Para establecer que las filas cambien automáticamente el tamaño siempre que cambie su contenido, use la AutoSizeRowsMode propiedad .

Para que el contenido de la celda se ajuste a varias líneas cuando se cambia el tamaño de una fila, el estilo de celda en vigor para la celda debe tener un WrapMode valor de propiedad de True.

Esta sobrecarga permite especificar un modo de ajuste de tamaño que calcule los nuevos altos en función de los valores de un conjunto limitado de celdas, como los que se muestran solo en filas mostradas. Esto mejora el rendimiento cuando el control contiene un gran número de filas.

Para obtener más información sobre el cambio de tamaño mediante programación, vea Opciones de ajuste de tamaño en el control DataGridView de Windows Forms.

Consulte también

Se aplica a

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.

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.

rowsCount
Int32

Número de filas cuyo tamaño se va a ajustar.

autoSizeRowMode
DataGridViewAutoSizeRowMode

Uno de los valores de DataGridViewAutoSizeRowMode.

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.

Excepciones

autoSizeRowsMode tiene el valor AllHeaders o DisplayedHeaders, y RowHeadersVisible es false.

autoSizeRowsMode no es un valor DataGridViewAutoSizeRowsMode válido.

autoSizeRowsMode tiene el valor None.

rowIndexStart es menor que 0.

o bien

rowsCount es menor que 0.

Comentarios

Este método es útil si desea controlar cuándo cambian el tamaño de las filas, pero solo quiere 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. Las alturas de fila de las filas especificadas se ajustan solo una vez por llamada al método; Si el contenido de las filas cambia más adelante, las filas no se ajustarán automáticamente. Para cambiar el tamaño de una fila específica, use el AutoResizeRow método . Para cambiar el tamaño de todas las filas, use una sobrecarga diferente del AutoResizeRows método . Para establecer que las filas cambien automáticamente el tamaño siempre que cambie su contenido, use la AutoSizeRowsMode propiedad .

Para que el contenido de la celda se ajuste a varias líneas cuando se cambia el tamaño de una fila, el estilo de celda en vigor para la celda debe tener un WrapMode valor de propiedad de True.

Esta sobrecarga permite especificar un modo de ajuste de tamaño que calcule los nuevos altos en función de los valores de un conjunto limitado de celdas, como los que se muestran solo en filas mostradas. Esto mejora el rendimiento cuando el control contiene un gran número de filas.

Esta sobrecarga está protegida y está diseñada para permitirle lograr relaciones ideales de alto a ancho de celda en una clase derivada DataGridView . Si el fixedWidth parámetro es false, el alto de fila se calculará con la expectativa de llamar al AutoResizeColumn método o AutoResizeColumns siguiente.

Para obtener más información sobre el cambio de tamaño mediante programación, vea Opciones de ajuste de tamaño en el control DataGridView de Windows Forms.

Consulte también

Se aplica a

AutoResizeRows()

Ajusta el alto de todas las filas para adaptarlo al contenido de todas sus celdas, incluidas las celdas de encabezado.

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 en función del contenido de celdas que no son de encabezado. Este ejemplo de código forma parte de un ejemplo más grande proporcionado en 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. Las alturas de fila se ajustan una sola vez por llamada al método; Si el contenido de las filas cambia más adelante, las filas no se ajustarán automáticamente. Para cambiar el tamaño de una fila específica, use el AutoResizeRow método . Para cambiar el tamaño de un subconjunto de filas, use la AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) sobrecarga . Para establecer que las filas cambien automáticamente el tamaño siempre que cambie su contenido, use la AutoSizeRowsMode propiedad .

Para que el contenido de la celda se ajuste a varias líneas cuando se cambia el tamaño de una fila, el estilo de celda en vigor para la celda debe tener un WrapMode valor de propiedad de True.

Para obtener más información sobre el cambio de tamaño mediante programación, vea Opciones de ajuste de tamaño en el control DataGridView de Windows Forms.

Consulte también

Se aplica a

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.

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.

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.

Excepciones

autoSizeRowsMode tiene el valor AllHeaders o DisplayedHeaders, y RowHeadersVisible es false.

autoSizeRowsMode no es un valor DataGridViewAutoSizeRowsMode válido.

autoSizeRowsMode tiene el valor None.

Comentarios

Este método es útil si desea controlar cuándo se cambia el tamaño de las filas. Las alturas de fila se ajustan una sola vez por llamada al método; Si el contenido de las filas cambia más adelante, las filas no se ajustarán automáticamente. Para cambiar el tamaño de una fila específica, use el AutoResizeRow método . Para cambiar el tamaño de un subconjunto de filas, use la AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) sobrecarga . Para establecer que las filas cambien automáticamente el tamaño siempre que cambie su contenido, use la AutoSizeRowsMode propiedad .

Para que el contenido de la celda se ajuste a varias líneas cuando se cambia el tamaño de una fila, el estilo de celda en vigor para la celda debe tener un WrapMode valor de propiedad de True.

Esta sobrecarga permite especificar un modo de ajuste de tamaño que calcule los nuevos altos en función de los valores de un conjunto limitado de celdas, como los que se muestran solo en filas mostradas. Esto mejora el rendimiento cuando el control contiene un gran número de filas.

Esta sobrecarga está protegida y está diseñada para permitirle lograr relaciones ideales de alto a ancho de celda en una clase derivada DataGridView . Si el fixedWidth parámetro es false, el alto de fila se calculará con la expectativa de llamar al AutoResizeColumn método o AutoResizeColumns siguiente.

Para obtener más información sobre el cambio de tamaño mediante programación, vea Opciones de ajuste de tamaño en el control DataGridView de Windows Forms.

Consulte también

Se aplica a