Langage

DataGridViewAutoSizeColumnMode Énumération

Définition

Définit des valeurs pour spécifier la façon dont la largeur d’une colonne est ajustée.

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

Champs

Nom Valeur Description
NotSet 0

Le comportement de dimensionnement de la colonne est hérité de la AutoSizeColumnsMode propriété.

None 1

La largeur de colonne ne s’ajuste pas automatiquement.

ColumnHeader 2

La largeur de colonne s’ajuste en fonction du contenu de la cellule d’en-tête de colonne.

AllCellsExceptHeader 4

La largeur de colonne s’ajuste pour ajuster le contenu de toutes les cellules de la colonne, à l’exclusion de la cellule d’en-tête.

AllCells 6

La largeur de colonne s’ajuste pour ajuster le contenu de toutes les cellules de la colonne, y compris la cellule d’en-tête.

DisplayedCellsExceptHeader 8

La largeur de colonne s’ajuste en fonction du contenu de toutes les cellules de la colonne actuellement affichées à l’écran, à l’exclusion de la cellule d’en-tête.

DisplayedCells 10

La largeur de colonne s’ajuste pour ajuster le contenu de toutes les cellules de la colonne qui se trouvent dans des lignes actuellement affichées à l’écran, y compris la cellule d’en-tête.

Fill 16

La largeur de colonne s’ajuste afin que les largeurs de toutes les colonnes remplissent exactement la zone d’affichage du contrôle, ce qui nécessite un défilement horizontal uniquement pour conserver les largeurs de colonne au-dessus MinimumWidth des 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 pour configurer une colonne à largeur fixe. Cet exemple fait partie d’un exemple plus large disponible dans 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

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 le mode Remplissage, la largeur préférée d’une colonne est déterminée par le redimensionnement de 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 les AutoSizeModeInheritedAutoSizeMode propriétés des colonnes et de la DataGridView.AutoResizeColumn méthode.

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.

S’applique à

Voir aussi