TabControl.Selecting Événement
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.
Se produit avant qu’un onglet soit sélectionné, ce qui permet à un gestionnaire d’annuler la modification de l’onglet.
public:
event System::Windows::Forms::TabControlCancelEventHandler ^ Selecting;public event System.Windows.Forms.TabControlCancelEventHandler Selecting;public event System.Windows.Forms.TabControlCancelEventHandler? Selecting;member this.Selecting : System.Windows.Forms.TabControlCancelEventHandler Public Custom Event Selecting As TabControlCancelEventHandler Type d'événement
Exemples
L’exemple de code suivant illustre l’utilisation de ce membre. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement Selecting . Ce rapport vous aide à apprendre quand l’événement se produit et peut vous aider à déboguer. Pour signaler plusieurs événements ou événements qui se produisent fréquemment, envisagez de MessageBox.ShowConsole.WriteLine remplacer ou d’ajouter le message à un multiligne TextBox.
Pour exécuter l’exemple de code, collez-le dans un projet qui contient une instance de type TabControl nommée TabControl1. Vérifiez ensuite que le gestionnaire d’événements est associé à l’événement Selecting .
private void TabControl1_Selecting(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(), "Selecting Event" );
}
Private Sub TabControl1_Selecting(sender as Object, e as TabControlCancelEventArgs) _
Handles TabControl1.Selecting
Dim messageBoxVB as New System.Text.StringBuilder()
messageBoxVB.AppendFormat("{0} = {1}", "TabPage", e.TabPage)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "TabPageIndex", e.TabPageIndex)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "Action", e.Action)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "Cancel", e.Cancel)
messageBoxVB.AppendLine()
MessageBox.Show(messageBoxVB.ToString(),"Selecting Event")
End Sub
Remarques
Lorsque l’onglet actuel change dans un 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’une modification d’onglet si un TabPage état n’est pas valide ou la mise à jour de l’état d’un nouvel TabPageaffichage.
L’onglet actuel change lorsque l’utilisateur clique sur un onglet, lorsque vous appelez la ou la DeselectTabSelectTab méthode, ou lorsque vous modifiez la valeur de la ou SelectedIndex de la SelectedTab propriété.
