DataGridViewAutoSizeColumnMode 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 ajusta el ancho de una columna.
public enum class DataGridViewAutoSizeColumnMode
public enum DataGridViewAutoSizeColumnMode
type DataGridViewAutoSizeColumnMode =
Public Enum DataGridViewAutoSizeColumnMode
- Herencia
Campos
| Nombre | Valor | Description |
|---|---|---|
| NotSet | 0 | El comportamiento de ajuste de tamaño de la columna se hereda de la AutoSizeColumnsMode propiedad . |
| None | 1 | El ancho de columna no se ajusta automáticamente. |
| ColumnHeader | 2 | El ancho de columna se ajusta para ajustarse al contenido de la celda de encabezado de columna. |
| AllCellsExceptHeader | 4 | El ancho de columna se ajusta para ajustarse al contenido de todas las celdas de la columna, excepto la celda de encabezado. |
| AllCells | 6 | El ancho de columna se ajusta para ajustarse al contenido de todas las celdas de la columna, incluida la celda de encabezado. |
| DisplayedCellsExceptHeader | 8 | El ancho de columna se ajusta para ajustarse al contenido de todas las celdas de la columna que se muestran actualmente en pantalla, excepto la celda de encabezado. |
| DisplayedCells | 10 | El ancho de columna se ajusta para ajustarse al contenido de todas las celdas de la columna que se muestran actualmente en pantalla, incluida la celda de encabezado. |
| Fill | 16 | El ancho de columna se ajusta 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 valores de propiedad MinimumWidth . 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 para configurar una columna de ancho fijo. Este ejemplo forma parte de un ejemplo más grande disponible en How to: Set the Sizing Modes of the Windows Forms DataGridView Control.
DataGridViewTextBoxColumn idColumn =
new DataGridViewTextBoxColumn();
idColumn.HeaderText = "ID";
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None;
idColumn.Resizable = DataGridViewTriState.False;
idColumn.ReadOnly = true;
idColumn.Width = 20;
Dim idColumn As New DataGridViewTextBoxColumn()
idColumn.HeaderText = "ID"
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None
idColumn.Resizable = DataGridViewTriState.False
idColumn.ReadOnly = True
idColumn.Width = 20
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 el modo relleno, 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 usan las AutoSizeMode propiedades y InheritedAutoSizeMode de las columnas y el DataGridView.AutoResizeColumn 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.
Se aplica a
Consulte también
- DataGridView
- AutoSizeMode
- AutoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
- AutoResizeColumn
- AutoResizeColumns
- Opciones de tamaño en el control DataGridView de Windows Forms
- Modo de relleno de columnas en el control de DataGridView de Windows Forms
- Cómo: Configurar los modos de tamaño del control DataGridView de Windows Forms