DataGridView.AutoSizeRowsMode Propiedad

Definición

Obtiene o establece un valor que indica cómo se determina el alto de las filas.Gets or sets a value indicating how row heights are determined.

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

Valor de DataGridViewAutoSizeRowsMode que indica el modo de ajuste del tamaño.A DataGridViewAutoSizeRowsMode value indicating the sizing mode. El valor predeterminado es None.The default is None.

Excepciones

El valor especificado al establecer esta propiedad no es un valor de DataGridViewAutoSizeRowsMode válido.The specified value when setting this property is not a valid DataGridViewAutoSizeRowsMode value.

El valor especificado al establecer esta propiedad es AllHeaders o DisplayedHeaders y los encabezados de fila se ocultan.The specified value when setting this property is AllHeaders or DisplayedHeaders and row headers are hidden.

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.The following code example demonstrates how to set the row to automatically resize based on the contents of the row headers and all of the columns. Este ejemplo de código forma parte de un ejemplo más grande que se proporciona en Cómo: cambiar automáticamente el tamaño de las celdas cuando cambia el contenido en el control DataGridView Windows Forms.This code example is part of a larger example provided in 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 le permite configurar el control de modo que el alto de las filas se ajuste automáticamente para ajustarse a su contenido cada vez que cambie el contenido.This property lets you configure the control so that row heights are automatically adjusted to fit their contents whenever the contents change. Si WrapMode está habilitado, también se ajusta el alto de las filas cada vez que cambie el ancho de las columnas.If WrapMode is enabled, row heights are also adjusted whenever column widths change. Algunos modos de ajuste de tamaño permiten limitar el ajuste de tamaño a las filas mostradas actualmente para aumentar el rendimiento.Some sizing modes let you limit the size adjustment to the currently displayed rows in order to increase performance.

Solo se cambia automáticamente el tamaño de las filas con un valor de propiedad Visible de true y el cambio de la visibilidad de una fila no produce el cambio de tamaño.Only rows with a Visible property value of true are resized automatically, and changing the visibility of a row does not cause resizing to occur. Además, cuando las filas están configuradas para cambiar de tamaño automáticamente, el usuario no puede ajustar el alto de las filas con el mouse.Additionally, when rows are set to automatically resize, the user cannot adjust the row heights with the mouse.

El valor Height 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 utiliza.The Height value of an automatically sized row is recalculated during layout to account for the size of the font that is used. Para obtener el Heightcorrecto, debe recuperar el valor en el evento de Layout del formulario en lugar de en el constructor del formulario.To get the correct Height, you should retrieve the value in the form's Layout event instead of in the form's constructor.

Para ajustar el alto de las filas mediante programación, use los métodos AutoResizeRow o AutoResizeRows o establezca la propiedad Row Height.To adjust row heights programmatically, use the AutoResizeRow or AutoResizeRows methods, or set the row Height property.

Para que el contenido de la celda se ajuste en varias líneas cuando se cambia el tamaño de una fila, el estilo de celda en vigor para la celda debe tener un valor de propiedad WrapMode de True.For cell contents to wrap onto multiple lines when a row is resized, the cell style in effect for the cell must have a WrapMode property value of True.

Para obtener más información sobre el ajuste automático de tamaño basado en el contenido, consulte Opciones de ajuste de tamaño en el control DataGridView Windows Forms.For more information about content-based automatic sizing, see Sizing Options in the Windows Forms DataGridView Control.

Se aplica a

Consulte también: