DataGridView.AutoResizeRows Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic 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 -> unitProtected 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.
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 -> unitPublic 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 -> unitProtected 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.
