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

TabControl.Deselecting, événement

Mise à jour : novembre 2007

Se produit avant qu'un onglet soit désélectionné, en activant un gestionnaire pour annuler la modification de l'onglet.

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

public event TabControlCancelEventHandler Deselecting
/** @event */
public void add_Deselecting (TabControlCancelEventHandler value)
/** @event */
public void remove_Deselecting (TabControlCancelEventHandler value)

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

Lorsque l'onglet actif change dans TabControl, les événements suivants se produisent dans l'ordre suivant.

Ces événements vous permettent d'effectuer des tâches telles que l'annulation d'un changement d'onglet si l'état de TabPage n'est pas valide ou la mise à jour de l'état d'un TabPage affiché.

L'onglet actuel change lorsque l'utilisateur clique sur un onglet, lorsque vous appelez la méthode DeselectTab ou SelectTab, ou lorsque vous modifiez la valeur de la propriété SelectedIndex ou SelectedTab.

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 Deselecting. 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 TabControl nommée TabControl1. Assurez-vous ensuite que le gestionnaire d'événements est associé à l'événement Deselecting.

private void TabControl1_Deselecting(Object sender, TabControlCancelEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "TabPage", e.TabPage );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "TabPageIndex", e.TabPageIndex );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Action", e.Action );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Cancel", e.Cancel );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "Deselecting 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: