DataGridViewAutoSizeColumnsMode Énumération

Définition

Définit des valeurs pour spécifier comment les largeurs de colonnes sont ajustées.Defines values for specifying how the widths of columns are adjusted.

public enum class DataGridViewAutoSizeColumnsMode
public enum DataGridViewAutoSizeColumnsMode
type DataGridViewAutoSizeColumnsMode = 
Public Enum DataGridViewAutoSizeColumnsMode
Héritage
DataGridViewAutoSizeColumnsMode

Champs

AllCells 6

Les largeurs de colonne s'ajustent pour correspondre au contenu de toutes les cellules des colonnes, y compris les cellules d'en-tête.The column widths adjust to fit the contents of all cells in the columns, including header cells.

AllCellsExceptHeader 4

Les largeurs de colonne s'ajustent pour correspondre au contenu de toutes les cellules des colonnes, sauf les cellules d'en-tête.The column widths adjust to fit the contents of all cells in the columns, excluding header cells.

ColumnHeader 2

Les largeurs de colonne s'ajustent pour correspondre au contenu des cellules de l'en-tête de colonne.The column widths adjust to fit the contents of the column header cells.

DisplayedCells 10

Les largeurs de colonne s'ajustent pour correspondre au contenu de toutes les cellules des colonnes qui sont dans les lignes affichées à l'écran actuellement, y compris les cellules d'en-tête.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

Les largeurs de colonne s'ajustent pour correspondre au contenu de toutes les cellules des colonnes qui sont dans les lignes affichées à l'écran actuellement, sauf les cellules d'en-tête.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

Les largeurs de colonne s'ajustent afin que les largeurs de toutes les colonnes remplissent exactement la zone d'affichage du contrôle, nécessitant uniquement un défilement horizontal pour conserver des largeurs de colonne au-dessus des valeurs de propriété 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. Les largeurs de colonne relatives sont déterminées par les valeurs de propriété FillWeight relatives.Relative column widths are determined by the relative FillWeight property values.

None 1

Les largeurs de colonne ne s'ajustent pas automatiquement.The column widths do not automatically adjust.

Exemples

L’exemple de code suivant illustre l’utilisation de cette énumération dans un scénario maître/détails où DataGridView deux contrôles affichent des données de deux tables dans une relation parent/enfant.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. Dans cet exemple, le mode de dimensionnement de colonne pour le contrôle maître est None et les largeurs de colonne sont initialisées par programmation pour s’ajuster aux valeurs chargées.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. Le contrôle des détails est défini sur un mode de dimensionnement automatique afin que les colonnes s’ajustent automatiquement chaque fois que les valeurs changent (par exemple, lorsque l’utilisateur modifie la ligne actuelle dans la table parente).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). Cet exemple fait partie d’un exemple plus complet disponible dans How to: Créez un formulaire maître/détail à l’aide de deuxcontrôles Windows Forms DataGridView.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

Remarques

Le DataGridView contrôle peut redimensionner ses colonnes pour qu’elles remplissent la largeur horizontale disponible du contrôle ou qu’elles affichent le contenu complet de toutes les cellules ou des cellules spécifiées.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.

Avec Fill le mode, la largeur par défaut d’une colonne est déterminée par le redimensionnement de toutes les colonnes dans ce mode, de sorte que toutes les colonnes visibles dans le contrôle remplissent exactement la largeur horizontale de la zone d’affichage 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. Avec d’autres modes, la largeur de colonne par défaut est la largeur minimale requise pour afficher la plus grande valeur de cellule à partir de toutes les cellules ou d’un sous-ensemble de cellules de cette colonne, comme le sous-ensemble de cellules qui se trouvent dans les lignes actuellement affichées.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. L’utilisation d’un sous-ensemble de cellules pour déterminer la nouvelle largeur est utile pour éviter une altération des performances lorsque vous travaillez avec de nombreuses lignes de données.Using a subset of cells to determine the new width is useful to avoid a performance penalty when working with many rows of data.

Le redimensionnement automatique basé sur le contenu empêche les utilisateurs d’ajuster la largeur des colonnes avec la souris.Content-based automatic resizing prevents users from adjusting column widths with the mouse. Toutefois, le redimensionnement de l’utilisateur est activé en mode de remplissage.User resizing is enabled in fill mode, however.

Cette énumération est utilisée par DataGridView la AutoSizeColumnsMode propriété et AutoResizeColumns la méthode de contrôle.This enumeration is used by the DataGridView control AutoSizeColumnsMode property and AutoResizeColumns method.

Pour plus d’informations sur les modes de dimensionnement, consultez options de dimensionnement dans le Windows Forms contrôle DataGridView.For more information about sizing modes, see Sizing Options in the Windows Forms DataGridView Control. Pour plus d’informations sur le mode de remplissage de colonne en particulier, consultez mode de remplissage des colonnes dans le contrôle DataGridView Windows Forms.For more information about column fill mode in particular, see Column Fill Mode in the Windows Forms DataGridView Control.

S’applique à

Voir aussi