DataGridView.AutoSizeRowsMode Propiedad
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í.
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, setPublic Property AutoSizeRowsMode As DataGridViewAutoSizeRowsModeValor de propiedad
Valor de DataGridViewAutoSizeRowsMode que indica el modo de ajuste del tamaño. De manera predeterminada, es None.
Excepciones
El valor especificado al establecer esta propiedad no es un valor de DataGridViewAutoSizeRowsMode válido.
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.
