TabControlCancelEventArgs Classe

Définition

Fournit des données pour les événements Selecting et Deselecting d'un contrôle TabControl.Provides data for the Selecting and Deselecting events of a TabControl control.

public ref class TabControlCancelEventArgs : System::ComponentModel::CancelEventArgs
public class TabControlCancelEventArgs : System.ComponentModel.CancelEventArgs
type TabControlCancelEventArgs = class
    inherit CancelEventArgs
Public Class TabControlCancelEventArgs
Inherits CancelEventArgs
Héritage
TabControlCancelEventArgs

Exemples

L’exemple de code suivant illustre l’utilisation de ce type.The following code example demonstrates the use of this type. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement Selecting.In the example, an event handler reports on the occurrence of the Selecting event. Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider à effectuer un débogage.This report helps you to learn when the event occurs and can assist you in debugging. Pour effectuer un rapport sur plusieurs événements ou sur des événements qui se produisent fréquemment, envisagez de remplacer Show par Console.WriteLine ou d’ajouter le message à un TextBoxmultiligne.To report on multiple events or on events that occur frequently, consider replacing Show with Console.WriteLine or appending the message to a multiline TextBox.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient une instance de type TabControl nommée TabControl1.To run the example code, paste it into a project that contains an instance of type TabControl named TabControl1. Assurez-vous ensuite que le gestionnaire d’événements est associé à l’événement Selecting.Then ensure that the event handler is associated with the Selecting event.

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

Utilisez la propriété Action pour déterminer l’événement qui se produit.Use the Action property to determine which event is occurring. Cela vous permet de gérer plusieurs types d’événements avec un gestionnaire d’événements.This enables you to handle multiple event types with one event handler.

Utilisez les propriétés TabPage et TabPageIndex pour déterminer le TabPage pour lequel l’événement se produit.Use the TabPage and TabPageIndex properties to determine which TabPage the event is occurring for.

Pour annuler une modification d’onglet dans un TabControl, affectez à la propriété Cancel la valeur true.To cancel a tab change in a TabControl, set the Cancel property to true.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.For more information about handling events, see Handling and Raising Events.

Constructeurs

TabControlCancelEventArgs(TabPage, Int32, Boolean, TabControlAction)

Initialise une nouvelle instance de la classe TabControlCancelEventArgs.Initializes a new instance of the TabControlCancelEventArgs class.

Propriétés

Action

Obtient une valeur indiquant l'événement qui se produit.Gets a value indicating which event is occurring.

Cancel

Obtient ou définit une valeur indiquant si l'événement doit être annulé.Gets or sets a value indicating whether the event should be canceled.

(Hérité de CancelEventArgs)
TabPage

Obtient le TabPage pour lequel l'événement se produit.Gets the TabPage the event is occurring for.

TabPageIndex

Obtient l'index de base zéro de TabPage dans la collection TabPages.Gets the zero-based index of the TabPage in the TabPages collection.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi