DataGridViewColumn.AutoSizeMode Propriété
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.
Obtient ou définit le mode par lequel la colonne ajuste automatiquement sa largeur.
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, setPublic Property AutoSizeMode As DataGridViewAutoSizeColumnModeValeur de propriété
Valeur DataGridViewAutoSizeColumnMode qui détermine si la colonne ajuste automatiquement sa largeur et comment elle détermine sa largeur préférée. La valeur par défaut est NotSet.
Exceptions
La valeur spécifiée lors de la définition de cette propriété est une DataGridViewAutoSizeColumnMode valeur qui n’est pas valide.
La valeur spécifiée lors de la définition de cette propriété entraîne la InheritedAutoSizeMode valeur d’une ColumnHeader colonne visible lorsque les en-têtes de colonne sont masqués.
- ou -
La valeur spécifiée lors de la définition de cette propriété entraîne la valeur d’une InheritedAutoSizeModeFill colonne visible qui est figée.
Exemples
L’exemple de code suivant force une colonne à redimensionner automatiquement sa largeur en fonction de son contenu. Cet exemple de code fait partie d’un exemple plus grand fourni pour la DataGridViewColumn classe.
// 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
Remarques
Le comportement de dimensionnement automatique de la colonne est déterminé par la valeur de la InheritedAutoSizeMode propriété, qui est identique à la valeur de la AutoSizeMode propriété pour toutes les valeurs, sauf NotSet, ce qui indique que la valeur est héritée de la propriété à la DataGridView.AutoSizeColumnsMode place.
Lorsque la valeur de InheritedAutoSizeMode la propriété est Fill, la colonne est redimensionnée avec d’autres colonnes en ce mode. Toutes les colonnes en mode remplissage du contrôle divisent l’espace disponible en proportions déterminées par leurs FillWeight valeurs de propriété. La largeur disponible pour le mode de remplissage est déterminée en soustrayant les largeurs de toutes les autres colonnes de la largeur de la zone cliente du contrôle. Si cette largeur est inférieure aux valeurs combinées MinimumWidth de toutes les colonnes en mode remplissage, la barre de défilement horizontale s’affiche, toutes les colonnes en mode remplissage sont affichées avec leurs largeurs minimales et le redimensionnement des colonnes utilisateur est désactivé. Pour plus d’informations sur le mode de remplissage de colonne, consultez le mode remplissage de colonne dans le contrôle DataGridView Windows Forms.
Lorsque la InheritedAutoSizeMode propriété est définie sur une autre valeur, sauf Noneque la colonne gère sa largeur afin que ses valeurs de cellule soient entièrement affichées sans découpage. Dans les modes de dimensionnement basés sur le contenu, les ajustements de taille se produisent chaque fois que le contenu de la cellule change ou, s’il WrapMode est activé, chaque fois que les hauteurs de ligne changent. Certains modes de dimensionnement basés sur le contenu vous permettent de limiter l’ajustement de la taille aux lignes actuellement affichées afin d’augmenter les performances.
Seules les colonnes dont Visible la valeur de true propriété est redimensionnée sont redimensionnées et la modification de la visibilité d’une colonne ne provoque pas le redimensionnement. En outre, lorsque les colonnes sont définies pour redimensionner automatiquement, l’utilisateur ne peut pas ajuster les largeurs de colonne avec la souris.
Pour ajuster les largeurs de colonne par programmation, utilisez les DataGridView méthodes ou AutoResizeColumns les méthodes du AutoResizeColumn contrôle ou définissez la propriété de colonneWidth.
Pour plus d’informations sur le dimensionnement automatique basé sur le contenu, consultez Options de dimensionnement dans le contrôle DataGridView Windows Forms.
