DataGridView.AutoResizeRow 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 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
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
autoSizeRowMode
tiene el valor RowHeader y RowHeadersVisible es false
.
autoSizeRowMode
no es un valor DataGridViewAutoSizeRowMode válido.
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
autoSizeRowMode
tiene el valor RowHeader y RowHeadersVisible es false
.
autoSizeRowMode
no es un valor DataGridViewAutoSizeRowMode válido.
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.