Cette documentation est archivée et n’est pas conservée.

DataGridView.ColumnStateChanged, événement

Mise à jour : novembre 2007

Se produit lorsque l'état d'une colonne est modifié, par exemple en obtenant ou en perdant le focus.

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

public event DataGridViewColumnStateChangedEventHandler ColumnStateChanged
/** @event */
public void add_ColumnStateChanged (DataGridViewColumnStateChangedEventHandler value)
/** @event */
public void remove_ColumnStateChanged (DataGridViewColumnStateChangedEventHandler value)

JScript ne prend pas en charge les événements.

Cet événement est déclenché lorsque la valeur de l'une des propriétés de colonne suivantes devient DataGridViewColumn dans le contrôle :

Pour plus d'informations sur la gestion d'événements, consultez Consommation d'événements.

L'exemple de code suivant illustre l'utilisation de ce membre. Dans l'exemple, un gestionnaire d'événements génère des rapports sur l'occurrence de l'événement ColumnStateChanged. Ce rapport vous permet de savoir quand l'événement se produit et peut vous aider pendant le débogage. Pour générer un rapport sur plusieurs événements ou sur des événements qui se produisent fréquemment, pensez à remplacer MessageBox.Show par Console.WriteLine ou à ajouter le message à un TextBox multiligne.

Pour exécuter l'exemple de code, collez-le dans un projet qui contient une instance de type DataGridView nommée DataGridView1. Assurez-vous ensuite que le gestionnaire d'événements est associé à l'événement ColumnStateChanged.

private void DataGridView1_ColumnStateChanged(Object sender, DataGridViewColumnStateChangedEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Column", e.Column );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "StateChanged", e.StateChanged );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "ColumnStateChanged Event" );
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Afficher: