DataGridView.AutoSizeRowsMode Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece un valor que indica cómo se determina el alto de las filas.

public:
 property System::Windows::Forms::DataGridViewAutoSizeRowsMode AutoSizeRowsMode { System::Windows::Forms::DataGridViewAutoSizeRowsMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeRowsMode value); };

public System.Windows.Forms.DataGridViewAutoSizeRowsMode AutoSizeRowsMode { get; set; }

member this.AutoSizeRowsMode : System.Windows.Forms.DataGridViewAutoSizeRowsMode with get, set

Public Property AutoSizeRowsMode As DataGridViewAutoSizeRowsMode

Valor de propiedad

DataGridViewAutoSizeRowsMode

Valor de DataGridViewAutoSizeRowsMode que indica el modo de ajuste del tamaño. De manera predeterminada, es None.

Excepciones

InvalidEnumArgumentException

El valor especificado al establecer esta propiedad no es un valor de DataGridViewAutoSizeRowsMode válido.

InvalidOperationException

El valor especificado al establecer esta propiedad es AllHeaders o DisplayedHeaders y los encabezados de fila se ocultan.

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer la fila para cambiar el tamaño automáticamente en función del contenido de los encabezados de fila y de todas las columnas. Este ejemplo de código forma parte de un ejemplo más grande proporcionado en How to: Automatically Resize Cells When Content Changes in the Windows Forms DataGridView Control.

void AutoSizeRowsMode( Object^ /*sender*/, EventArgs^ /*es*/ )
{
   dataGridView1->AutoSizeRowsMode = DataGridViewAutoSizeRowsMode::AllCells;
}

private void AutoSizeRowsMode(Object sender, EventArgs es)
{
    dataGridView1.AutoSizeRowsMode =
        DataGridViewAutoSizeRowsMode.AllCells;
}

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

    DataGridView1.AutoSizeRowsMode = _
        DataGridViewAutoSizeRowsMode.AllCells

End Sub

Comentarios

Esta propiedad permite configurar el control para que los altos de fila se ajusten automáticamente para ajustarse a su contenido siempre que cambie el contenido. Si WrapMode está habilitado, los alto de fila también se ajustan cada vez que cambian los anchos de columna. Algunos modos de ajuste de tamaño permiten limitar el ajuste de tamaño a las filas mostradas actualmente para aumentar el rendimiento.

Solo las filas con un Visible valor de propiedad de true se cambian de tamaño automáticamente y cambiar la visibilidad de una fila no hace que se produzca el cambio de tamaño. Además, cuando las filas se establecen para cambiar el tamaño automáticamente, el usuario no puede ajustar las alturas de fila con el mouse.

El Height valor de una fila de tamaño automático se vuelve a calcular durante el diseño para tener en cuenta el tamaño de la fuente que se usa. Para obtener el valor correcto Height, debe recuperar el valor en el evento del Layout formulario en lugar de en el constructor del formulario.

Para ajustar los alto de fila mediante programación, use los AutoResizeRow métodos o AutoResizeRows o o establezca la propiedad row Height .

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 tamaño automático basado en contenido, vea Opciones de ajuste de tamaño en el control DataGridView de Windows Forms.

Consulte también

• DataGridViewAutoSizeRowsMode
• DataGridView (Control, formularios Windows Forms)
• Cómo: Cambiar automáticamente el tamaño de las celdas cuando se modifica el contenido en un control DataGridView de formularios Windows Forms