DataGridViewAutoSizeColumnsMode Enumeración
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í.
Define valores para especificar cómo se ajustan los anchos de las columnas.
public enum class DataGridViewAutoSizeColumnsModepublic enum DataGridViewAutoSizeColumnsModetype DataGridViewAutoSizeColumnsMode = Public Enum DataGridViewAutoSizeColumnsMode- Herencia
Campos
| Nombre | Valor | Description |
|---|---|---|
| None | 1 | Los anchos de columna no se ajustan automáticamente. |
| ColumnHeader | 2 | Los anchos de columna se ajustan para ajustarse al contenido de las celdas del encabezado de columna. |
| AllCellsExceptHeader | 4 | Los anchos de columna se ajustan para ajustarse al contenido de todas las celdas de las columnas, excepto las celdas de encabezado. |
| AllCells | 6 | Los anchos de columna se ajustan para ajustarse al contenido de todas las celdas de las columnas, incluidas las celdas de encabezado. |
| DisplayedCellsExceptHeader | 8 | Los anchos de columna se ajustan para ajustarse al contenido de todas las celdas de las columnas que se muestran actualmente en pantalla, excepto las celdas de encabezado. |
| DisplayedCells | 10 | Los anchos de columna se ajustan para ajustarse al contenido de todas las celdas de las columnas que se muestran actualmente en pantalla, incluidas las celdas de encabezado. |
| Fill | 16 | Los anchos de columna se ajustan para que los anchos de todas las columnas rellenen exactamente el área de visualización del control, lo que requiere desplazamiento horizontal solo para mantener los anchos de columna por encima de los MinimumWidth valores de propiedad. Los anchos de columna relativos se determinan mediante los valores de propiedad relativos FillWeight . |
Ejemplos
En el ejemplo de código siguiente se muestra el uso de esta enumeración en un escenario maestro o de detalles en el que dos DataGridView controles muestran datos de dos tablas en una relación primaria o secundaria. En este ejemplo, el modo de ajuste de tamaño de columna para el control maestro es None y los anchos de columna se inicializan mediante programación para ajustarse a los valores cargados. El control de detalles se establece en un modo de ajuste de tamaño automático para que las columnas se ajusten automáticamente siempre que cambien los valores (por ejemplo, cuando el usuario cambie la fila actual de la tabla primaria). Este ejemplo forma parte de un ejemplo más grande disponible en How to: Create a Master/Detail Form Using Two Windows Forms DataGridView Controls.
private void Form1_Load(object sender, System.EventArgs e)
{
// Bind the DataGridView controls to the BindingSource
// components and load the data from the database.
masterDataGridView.DataSource = masterBindingSource;
detailsDataGridView.DataSource = detailsBindingSource;
GetData();
// Resize the master DataGridView columns to fit the newly loaded data.
masterDataGridView.AutoResizeColumns();
// Configure the details DataGridView so that its columns automatically
// adjust their widths when the data changes.
detailsDataGridView.AutoSizeColumnsMode =
DataGridViewAutoSizeColumnsMode.AllCells;
}
Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Me.Load
' Bind the DataGridView controls to the BindingSource
' components and load the data from the database.
masterDataGridView.DataSource = masterBindingSource
detailsDataGridView.DataSource = detailsBindingSource
GetData()
' Resize the master DataGridView columns to fit the newly loaded data.
masterDataGridView.AutoResizeColumns()
' Configure the details DataGridView so that its columns automatically
' adjust their widths when the data changes.
detailsDataGridView.AutoSizeColumnsMode = _
DataGridViewAutoSizeColumnsMode.AllCells
End Sub
Comentarios
El DataGridView control puede cambiar el tamaño de sus columnas para que rellenen el ancho horizontal disponible del control o para que muestren el contenido completo de todas las celdas o de las celdas especificadas.
Con Fill el modo , el ancho preferido de una columna se determina al cambiar el tamaño de todas las columnas en ese modo para que todas las columnas visibles del control rellenen exactamente el ancho horizontal del área de visualización disponible. Con otros modos, el ancho de columna preferido es el ancho mínimo necesario para mostrar el valor de celda más grande de todas las celdas o un subconjunto de celdas de esa columna, como el subconjunto de celdas que están en filas mostradas actualmente. El uso de un subconjunto de celdas para determinar el nuevo ancho es útil para evitar una penalización de rendimiento al trabajar con muchas filas de datos.
El cambio de tamaño automático basado en contenido impide que los usuarios ajusten los anchos de columna con el mouse. Sin embargo, el cambio de tamaño del usuario está habilitado en modo de relleno.
Esta enumeración la usa la propiedad de control AutoSizeColumnsMode y AutoResizeColumns el DataGridView método .
Para obtener más información sobre los modos de ajuste de tamaño, vea Opciones de ajuste de tamaño en el control DataGridView de formularios Windows Forms. Para obtener más información sobre el modo de relleno de columnas en particular, vea Modo de relleno de columnas en el control DataGridView de formularios Windows Forms.
