DataGridViewColumn.AutoSizeMode Propiedad

Definición

Obtiene o establece el modo mediante el cual la columna ajusta automáticamente su tamaño.Gets or sets the mode by which the column automatically adjusts its width.

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnMode AutoSizeMode { System::Windows::Forms::DataGridViewAutoSizeColumnMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnMode value); };
public System.Windows.Forms.DataGridViewAutoSizeColumnMode AutoSizeMode { get; set; }
member this.AutoSizeMode : System.Windows.Forms.DataGridViewAutoSizeColumnMode with get, set
Public Property AutoSizeMode As DataGridViewAutoSizeColumnMode

Valor de propiedad

Valor de DataGridViewAutoSizeColumnMode que indica si la columna va a ajustar automáticamente su ancho y cómo va a determinar su ancho preferido.A DataGridViewAutoSizeColumnMode value that determines whether the column will automatically adjust its width and how it will determine its preferred width. De manera predeterminada, es NotSet.The default is NotSet.

Excepciones

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

El valor especificado al establecer esta propiedad provoca un valor de InheritedAutoSizeMode igual a ColumnHeader para una columna visible cuando los encabezados de columna están ocultos.The specified value when setting this property results in an InheritedAutoSizeMode value of ColumnHeader for a visible column when column headers are hidden.

O bien-or- El valor especificado al establecer esta propiedad provoca un valor de InheritedAutoSizeMode igual a Fill para una columna visible inmovilizada.The specified value when setting this property results in an InheritedAutoSizeMode value of Fill for a visible column that is frozen.

Ejemplos

En el ejemplo de código siguiente se fuerza a que una columna cambie automáticamente el tamaño del ancho para ajustarse a su contenido.The following code example forces a column to automatically resize its width to fit its contents. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado DataGridViewColumn para la clase.This code example is part of a larger example provided for the DataGridViewColumn class.

// AutoSize the third column.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   DataGridViewColumn^ column = dataGridView->Columns[ 2 ];
   column->AutoSizeMode = DataGridViewAutoSizeColumnMode::DisplayedCells;
}


// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}
' AutoSize the third column.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim column As DataGridViewColumn = dataGridView.Columns(2)
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
End Sub

Comentarios

El comportamiento de ajuste automático de tamaño de la columna viene determinado por el InheritedAutoSizeMode valor de la propiedad, que es el mismo que el AutoSizeMode valor de la propiedad para NotSettodos los valores excepto, lo que indica que el valor se hereda del DataGridView.AutoSizeColumnsModeen su lugar.The automatic sizing behavior of the column is determined by the value of the InheritedAutoSizeMode property, which is the same as the value of the AutoSizeMode property for all values except NotSet, which indicates that the value is inherited from the DataGridView.AutoSizeColumnsMode property instead.

Cuando el InheritedAutoSizeMode valor de la Fillpropiedad es, se cambia el tamaño de la columna junto con otras columnas en ese modo.When the InheritedAutoSizeMode property value is Fill, the column is resized along with other columns in that mode. Todas las columnas en modo de relleno del control dividen el espacio disponible en las proporciones determinadas por FillWeight sus valores de propiedad.All fill-mode columns in the control divide the available space in proportions determined by their FillWeight property values. El ancho disponible para el modo de relleno se determina restando el ancho de todas las demás columnas del ancho del área cliente del control.The width available for fill mode is determined by subtracting the widths of all other columns from the width of the client area of the control. Si este ancho es menor que los valores MinimumWidth combinados de todas las columnas en modo de relleno, se muestra la barra de desplazamiento horizontal, se muestran todas las columnas en modo de relleno con el ancho mínimo y se deshabilita el cambio de tamaño de las columnas de usuario.If this width is smaller than the combined MinimumWidth values of all fill-mode columns, the horizontal scroll bar is displayed, all fill-mode columns are shown with their minimum widths, and user column-resizing is disabled. Para obtener más información sobre el modo de relleno de columnas, vea modo de relleno de columnas en el control DataGridView de Windows Forms.For more information about column fill mode, see Column Fill Mode in the Windows Forms DataGridView Control.

Cuando la InheritedAutoSizeMode propiedad se establece en cualquier otro valor, Noneexcepto, la columna administrará su ancho para que sus valores de celda se muestren por completo sin recortes.When the InheritedAutoSizeMode property is set to any other value except None, the column will manage its width so that its cell values are fully displayed without clipping. En los modos de ajuste de tamaño basado en contenido, los ajustes de tamaño se producen WrapMode cada vez que cambia el contenido de la celda o, si está habilitado, cuando cambia el alto de las filas.In content-based sizing modes, size adjustments occur whenever cell contents change or, if WrapMode is enabled, whenever row heights change. Algunos modos de ajuste de tamaño basados en contenido permiten limitar el ajuste de tamaño a las filas mostradas actualmente para aumentar el rendimiento.Some content-based sizing modes let you limit the size adjustment to the currently displayed rows in order to increase performance.

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

Para ajustar los anchos de columna mediante programación, DataGridView use los AutoResizeColumn métodos AutoResizeColumns o del control o establezca Width la propiedad de la columna.To adjust column widths programmatically, use the DataGridView control's AutoResizeColumn or AutoResizeColumns methods or set the column Width property.

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: