DataGridViewAutoSizeColumnsMode Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit des valeurs pour spécifier la façon dont les largeurs des colonnes sont ajustées.
public enum class DataGridViewAutoSizeColumnsModepublic enum DataGridViewAutoSizeColumnsModetype DataGridViewAutoSizeColumnsMode = Public Enum DataGridViewAutoSizeColumnsMode- Héritage
Champs
| Nom | Valeur | Description |
|---|---|---|
| None | 1 | Les largeurs de colonne ne s’ajustent pas automatiquement. |
| ColumnHeader | 2 | Les largeurs de colonne s’ajustent pour ajuster le contenu des cellules d’en-tête de colonne. |
| AllCellsExceptHeader | 4 | Les largeurs de colonne s’ajustent pour ajuster le contenu de toutes les cellules des colonnes, à l’exclusion des cellules d’en-tête. |
| AllCells | 6 | Les largeurs de colonne s’ajustent pour ajuster le contenu de toutes les cellules des colonnes, y compris les cellules d’en-tête. |
| DisplayedCellsExceptHeader | 8 | Les largeurs de colonne s’ajustent pour ajuster le contenu de toutes les cellules des colonnes qui se trouvent dans des lignes actuellement affichées à l’écran, à l’exclusion des cellules d’en-tête. |
| DisplayedCells | 10 | Les largeurs de colonne s’ajustent pour ajuster le contenu de toutes les cellules des colonnes qui se trouvent dans des lignes actuellement affichées à l’écran, y compris les cellules d’en-tête. |
| 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 un défilement horizontal uniquement pour conserver les largeurs de colonne au-dessus des MinimumWidth valeurs de propriété. Les largeurs de colonne relatives sont déterminées par les valeurs de propriété relatives FillWeight . |
Exemples
L’exemple de code suivant illustre l’utilisation de cette énumération dans un scénario maître/détails où deux DataGridView contrôles affichent des données de deux tables dans une relation parent/enfant. 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’adapter aux valeurs chargées. Le contrôle de 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). Cet exemple fait partie d’un exemple plus large disponible dans 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 pour qu’elles affichent le contenu complet de toutes les cellules ou de cellules spécifiées.
Avec Fill le mode, la largeur préférée d’une colonne est déterminée en redimensionnant toutes les colonnes de ce mode afin que toutes les colonnes visibles du contrôle remplissent exactement la largeur horizontale de la zone d’affichage disponible. Avec d’autres modes, la largeur de colonne préférée est la largeur minimale requise pour afficher la plus grande valeur de cellule de toutes les cellules ou un sous-ensemble de cellules de cette colonne, comme le sous-ensemble de cellules qui se trouvent dans les lignes actuellement affichées. L’utilisation d’un sous-ensemble de cellules pour déterminer la nouvelle largeur est utile pour éviter une pénalité de performances lors de l’utilisation de nombreuses lignes de données.
Le redimensionnement automatique basé sur le contenu empêche les utilisateurs d’ajuster les largeurs de colonne avec la souris. Toutefois, le redimensionnement de l’utilisateur est activé en mode de remplissage.
Cette énumération est utilisée par la propriété et AutoResizeColumns la DataGridView méthode de contrôleAutoSizeColumnsMode.
Pour plus d’informations sur les modes de dimensionnement, consultez Options de dimensionnement dans le contrôle DataGridView Windows Forms. Pour plus d’informations sur le mode de remplissage de colonne en particulier, consultez le mode remplissage de colonne dans le contrôle DataGridView Windows Forms.
