TabControl.Selecting Gebeurtenis

Definitie

Vindt plaats voordat een tabblad is geselecteerd, waardoor een handler de tabwijziging kan annuleren.

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 

Gebeurtenistype

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van dit lid. In het voorbeeld rapporteert een gebeurtenis-handler over het optreden van de Selecting gebeurtenis. Dit rapport helpt u te leren wanneer de gebeurtenis plaatsvindt en u kan helpen bij het opsporen van fouten. Als u wilt rapporteren over meerdere gebeurtenissen of gebeurtenissen die vaak optreden, kunt u overwegen het bericht te vervangen MessageBox.ShowConsole.WriteLine door of toe te voegen aan een multiline TextBox.

Als u de voorbeeldcode wilt uitvoeren, plakt u deze in een project dat een exemplaar van het type TabControl met de naam TabControl1bevat. Zorg er vervolgens voor dat de gebeurtenis-handler is gekoppeld aan de Selecting gebeurtenis.

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

Opmerkingen

Wanneer het huidige tabblad in een TabControlverandert, vinden de volgende gebeurtenissen plaats in de volgende volgorde.

Met deze gebeurtenissen kunt u taken uitvoeren, zoals het annuleren van een tabwijziging als een TabPage ongeldige status heeft of de status van een nieuw weergegeven item bijwerkt TabPage.

Het huidige tabblad wordt gewijzigd wanneer de gebruiker op een tabblad klikt, wanneer u de DeselectTab of SelectTab methode aanroept of wanneer u de waarde van de SelectedIndex of SelectedTab eigenschap wijzigt.

Van toepassing op

Zie ook