DataGridView.AutoResizeColumns 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 ancho de todas las columnas para adaptarlo al contenido de sus celdas.
Sobrecargas
AutoResizeColumns() |
Ajusta el ancho de todas las columnas para adaptarlo al contenido de todas sus celdas, incluidas las celdas de encabezado. |
AutoResizeColumns(DataGridViewAutoSizeColumnsMode) |
Ajusta el ancho de todas las columnas utilizando el modo de ajuste de tamaño especificado. |
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean) |
Ajusta el ancho de todas las columnas usando el modo de ajuste de tamaño especificado y, opcionalmente, calcula el ancho con la expectativa de que se ajuste a continuación el alto de las filas. |
AutoResizeColumns()
Ajusta el ancho de todas las columnas para adaptarlo al contenido de todas sus celdas, incluidas las celdas de encabezado.
public:
void AutoResizeColumns();
public void AutoResizeColumns ();
member this.AutoResizeColumns : unit -> unit
Public Sub AutoResizeColumns ()
Ejemplos
En el ejemplo de código siguiente se cambia el tamaño de todas las columnas para ajustarse al contenido de las columnas y los encabezados de 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 SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}
private void SizeAllColumns(Object sender, EventArgs e)
{
dataGridView1.AutoResizeColumns(
DataGridViewAutoSizeColumnsMode.AllCells);
}
Private Sub SizeAllColumns(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button6.Click
DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)
End Sub
Comentarios
Este método es útil si desea controlar cuándo cambian el tamaño de las columnas. Los anchos de columna se ajustan una sola vez por llamada al método; si el contenido de las columnas cambia más adelante, las columnas no se ajustarán automáticamente. Para cambiar el tamaño de una columna específica, use el AutoResizeColumn método . Para establecer que las columnas cambien automáticamente el tamaño siempre que cambie su contenido, utilice la AutoSizeColumnsMode propiedad o la propiedad de columna AutoSizeMode .
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
AutoResizeColumns(DataGridViewAutoSizeColumnsMode)
Ajusta el ancho de todas las columnas utilizando el modo de ajuste de tamaño especificado.
public:
void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
public void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode -> unit
Public Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode)
Parámetros
- autoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
Uno de los valores de DataGridViewAutoSizeColumnsMode.
Excepciones
autoSizeColumnsMode
tiene el valor ColumnHeader y ColumnHeadersVisible es false
.
autoSizeColumnsMode
no es un valor DataGridViewAutoSizeColumnsMode válido.
Ejemplos
En el ejemplo de código siguiente se cambia el tamaño de todas las columnas para ajustarse al contenido de las columnas y los encabezados de 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 SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}
private void SizeAllColumns(Object sender, EventArgs e)
{
dataGridView1.AutoResizeColumns(
DataGridViewAutoSizeColumnsMode.AllCells);
}
Private Sub SizeAllColumns(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button6.Click
DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)
End Sub
Comentarios
Este método es útil si desea controlar cuándo cambian el tamaño de las columnas. Los anchos de columna se ajustan una sola vez por llamada al método; si el contenido de las columnas cambia más adelante, las columnas no se ajustarán automáticamente. Para cambiar el tamaño de una columna específica, use el AutoResizeColumn método . Para establecer que las columnas cambien automáticamente el tamaño siempre que cambie su contenido, utilice la AutoSizeColumnsMode propiedad o la propiedad de columna AutoSizeMode .
Esta sobrecarga le permite especificar un modo de ajuste de tamaño que calcula los nuevos anchos 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
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)
Ajusta el ancho de todas las columnas usando el modo de ajuste de tamaño especificado y, opcionalmente, calcula el ancho con la expectativa de que se ajuste a continuación el alto de las filas.
protected:
void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
protected void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode * bool -> unit
Protected Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode, fixedHeight As Boolean)
Parámetros
- autoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
Uno de los valores de DataGridViewAutoSizeColumnsMode.
- fixedHeight
- Boolean
Es true
para calcular los nuevos anchos a partir del alto actual de las filas; es false
para calcular los anchos de forma que también se ajuste el alto de las filas.
Excepciones
autoSizeColumnsMode
tiene el valor ColumnHeader y ColumnHeadersVisible es false
.
autoSizeColumnsMode
no es un valor DataGridViewAutoSizeColumnsMode válido.
Comentarios
Este método es útil si desea controlar cuándo cambian el tamaño de las columnas. Los anchos de columna se ajustan una sola vez por llamada al método; si el contenido de las columnas cambia más adelante, las columnas no se ajustarán automáticamente. Para cambiar el tamaño de una columna específica, use el AutoResizeColumn método . Para establecer que las columnas cambien automáticamente el tamaño siempre que cambie su contenido, utilice la AutoSizeColumnsMode propiedad o la propiedad de columna AutoSizeMode .
Esta sobrecarga le permite especificar un modo de ajuste de tamaño que calcula los nuevos anchos 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 fixedHeight
es false
, los anchos de columna se calcularán con la expectativa de llamar al AutoResizeRow método o AutoResizeRows a continuación.
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.