DataGridView.AutoResizeRow Método

  • Referencia

Definición

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

Ajusta el alto de la fila especificada para adaptarla al contenido de sus celdas.

Sobrecargas

AutoResizeRow(Int32)

Ajusta el alto de la fila especificada para adaptarla al contenido de todas sus celdas, incluida la celda de encabezado.
AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)

Ajusta el alto de la fila especificada utilizando el modo de ajuste de tamaño especificado.
AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)

Ajusta el alto de la fila especificada 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.

AutoResizeRow(Int32)

Ajusta el alto de la fila especificada para adaptarla al contenido de todas sus celdas, incluida la celda de encabezado.

public:
 void AutoResizeRow(int rowIndex);
public void AutoResizeRow (int rowIndex);
member this.AutoResizeRow : int -> unit
Public Sub AutoResizeRow (rowIndex As Integer)

Parámetros

rowIndex
Int32

Índice de la fila cuyo tamaño se va a ajustar.

Excepciones

ArgumentOutOfRangeException

rowIndex no está en el intervalo válido de 0 al número de columnas menos 1.

Ejemplos

En el ejemplo de código siguiente se cambia el tamaño de la tercera fila de para DataGridView ajustarse al contenido de la columna. 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 SizeThirdRow( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRow(2, DataGridViewAutoSizeRowMode::AllCellsExceptHeader);
}

private void SizeThirdRow(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeRow(
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader);
}

Private Sub SizeThirdRow(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    Dim thirdRow As Integer = 2
    DataGridView1.AutoResizeRow( _
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader)

End Sub

Comentarios

Este método es útil si desea controlar cuándo cambia el tamaño de una fila. El alto de fila se ajusta solo una vez por llamada al método; si el contenido de la fila cambia más adelante, la fila no se ajustará automáticamente. Para cambiar el tamaño de todas las filas, use el AutoResizeRows método . Para establecer la fila para cambiar 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

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)

Ajusta el alto de la fila especificada utilizando el modo de ajuste de tamaño especificado.

public:
 void AutoResizeRow(int rowIndex, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode);
public void AutoResizeRow (int rowIndex, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode);
member this.AutoResizeRow : int * System.Windows.Forms.DataGridViewAutoSizeRowMode -> unit
Public Sub AutoResizeRow (rowIndex As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode)

Parámetros

rowIndex
Int32

Índice de la fila cuyo tamaño se va a ajustar.

autoSizeRowMode
DataGridViewAutoSizeRowMode

Uno de los valores de DataGridViewAutoSizeRowMode.

Excepciones

InvalidOperationException

autoSizeRowMode tiene el valor RowHeader y RowHeadersVisible es false.

InvalidEnumArgumentException

autoSizeRowMode no es un valor DataGridViewAutoSizeRowMode válido.

ArgumentOutOfRangeException

rowIndex no está en el intervalo válido de 0 al número de columnas menos 1.

Ejemplos

En el ejemplo de código siguiente se cambia el tamaño de la tercera fila de para DataGridView ajustarse al contenido de la columna. 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 SizeThirdRow( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRow(2, DataGridViewAutoSizeRowMode::AllCellsExceptHeader);
}

private void SizeThirdRow(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeRow(
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader);
}

Private Sub SizeThirdRow(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    Dim thirdRow As Integer = 2
    DataGridView1.AutoResizeRow( _
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader)

End Sub

Comentarios

Este método es útil si desea controlar cuándo cambia el tamaño de una fila. El alto de fila se ajusta solo una vez por llamada al método; si el contenido de la fila cambia más adelante, la fila no se ajustará automáticamente. Para cambiar el tamaño de todas las filas, use el AutoResizeRows método . Para establecer la fila para cambiar 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 le 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. 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

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)

Ajusta el alto de la fila especificada 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 AutoResizeRow(int rowIndex, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
protected void AutoResizeRow (int rowIndex, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
member this.AutoResizeRow : int * System.Windows.Forms.DataGridViewAutoSizeRowMode * bool -> unit
Protected Sub AutoResizeRow (rowIndex As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode, fixedWidth As Boolean)

Parámetros

rowIndex
Int32

Índice de la fila 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

InvalidOperationException

autoSizeRowMode tiene el valor RowHeader y RowHeadersVisible es false.

InvalidEnumArgumentException

autoSizeRowMode no es un valor DataGridViewAutoSizeRowMode válido.

ArgumentOutOfRangeException

rowIndex no está en el intervalo válido de 0 al número de columnas menos 1.

Comentarios

Este método es útil si desea controlar cuándo cambia el tamaño de una fila. El alto de fila se ajusta solo una vez por llamada al método; si el contenido de la fila cambia más adelante, la fila no se ajustará automáticamente. Para cambiar el tamaño de todas las filas, use el AutoResizeRows método . Para establecer la fila para cambiar 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 le 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. 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 fixedWidth 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