DataGridViewAutoSizeColumnsMode Enumeración

Definición

Define los valores para especificar cómo se ajustan los anchos de las columnas.Defines values for specifying how the widths of columns are adjusted.

public enum class DataGridViewAutoSizeColumnsMode
public enum DataGridViewAutoSizeColumnsMode
type DataGridViewAutoSizeColumnsMode = 
Public Enum DataGridViewAutoSizeColumnsMode
Herencia
DataGridViewAutoSizeColumnsMode

Campos

AllCells 6

Los anchos de columna se ajustan para adaptarse al contenido de todas las celdas de las columnas, incluidas las celdas de encabezado.The column widths adjust to fit the contents of all cells in the columns, including header cells.

AllCellsExceptHeader 4

Los anchos de columna se ajustan para adaptarse al contenido de todas las celdas de las columnas, sin incluir las celdas de encabezado.The column widths adjust to fit the contents of all cells in the columns, excluding header cells.

ColumnHeader 2

Los anchos de columna se ajustan para adaptarse al contenido de las celdas de encabezado de columna.The column widths adjust to fit the contents of the column header cells.

DisplayedCells 10

Los anchos de columna se ajustan para adaptarse al contenido de todas las celdas de las columnas que están en filas mostradas actualmente en la pantalla, incluidas las celdas de encabezado.The column widths adjust to fit the contents of all cells in the columns that are in rows currently displayed onscreen, including header cells.

DisplayedCellsExceptHeader 8

Los anchos de columna se ajustan para adaptarse al contenido de todas las celdas de las columnas que están en filas mostradas actualmente en la pantalla, sin incluir las celdas de encabezado.The column widths adjust to fit the contents of all cells in the columns that are in rows currently displayed onscreen, excluding header cells.

Fill 16

Los anchos de columna se ajustan para que los anchos de todas las columnas rellenen exactamente el área de presentación del control, por lo que sólo se requiere desplazamiento horizontal para mantener los anchos de columna por encima de los valores de la propiedad MinimumWidth.The column widths adjust so that the widths of all columns exactly fill the display area of the control, requiring horizontal scrolling only to keep column widths above the MinimumWidth property values. Los valores de la propiedad FillWeight relativos determinan los anchos de columna relativos.Relative column widths are determined by the relative FillWeight property values.

None 1

Los anchos de columna no se ajustan automáticamente.The column widths do not automatically adjust.

Ejemplos

En el ejemplo de código siguiente se muestra el uso de esta enumeración en un escenario principal/ DataGridView detalles en el que dos controles muestran datos de dos tablas en una relación de elementos primarios y secundarios.The following code example illustrates the use of this enumeration in a master/details scenario where two DataGridView controls display data from two tables in a parent/child relationship. En este ejemplo, el modo de cambio de tamaño de columna para el control maestro es ninguno y los anchos de columna se inicializan mediante programación para ajustarse a los valores cargados.In this example, the column sizing mode for the master control is None and the column widths are programmatically initialized to fit the loaded values. El control de detalles se establece en un modo de ajuste de tamaño automático para que las columnas se ajusten automáticamente cada vez que cambian los valores (por ejemplo, cuando el usuario cambia la fila actual de la tabla primaria).The details control is set to an automatic sizing mode so that columns will adjust automatically whenever the values change (for example, when the user changes the current row in the parent table). Este ejemplo forma parte de un ejemplo más grande disponible en cómo: Cree un formulario principal-detalle mediante dos controlesDataGridView Windows Forms.This example is part of a larger example available in 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 las columnas para que rellenen el ancho horizontal disponible del control o para que muestren todo el contenido de todas las celdas o de las celdas especificadas.The DataGridView control can resize its columns to make them fill the available horizontal width of the control or to make them display the full contents of all cells or of specified cells.

Con Fill el modo, el ancho preferido de una columna se determina cambiando 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 presentación disponible.With Fill mode, the preferred width of a column is determined by resizing all columns in that mode so that all visible columns in the control exactly fill the horizontal width of the available display area. 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 las filas que se muestran actualmente.With other modes, the preferred column width is the minimum width required to display the largest cell value from all cells or a subset of cells in that column, such as the subset of cells that are in currently displayed rows. El uso de un subconjunto de celdas para determinar el nuevo ancho es útil para evitar una reducción del rendimiento al trabajar con muchas filas de datos.Using a subset of cells to determine the new width is useful to avoid a performance penalty when working with many rows of data.

El cambio de tamaño automático basado en el contenido evita que los usuarios ajusten el ancho de las columnas con el mouse.Content-based automatic resizing prevents users from adjusting column widths with the mouse. Sin embargo, el cambio de tamaño de usuario está habilitado en el modo de relleno.User resizing is enabled in fill mode, however.

Esta enumeración la usan la DataGridView propiedad AutoSizeColumnsMode de control AutoResizeColumns y el método.This enumeration is used by the DataGridView control AutoSizeColumnsMode property and AutoResizeColumns method.

Para obtener más información sobre los modos de ajuste de tamaño, consulte Opciones de ajuste de tamaño en el control DataGridView Windows Forms.For more information about sizing modes, see Sizing Options in the Windows Forms DataGridView Control. Para obtener más información sobre el modo de relleno de columnas en particular, vea el modo de relleno de columnas en el control DataGridView de Windows Forms.For more information about column fill mode in particular, see Column Fill Mode in the Windows Forms DataGridView Control.

Se aplica a

Consulte también: