TabControl.Selecting Ereignis

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Tritt ein, bevor eine Registerkarte ausgewählt wird. Dies ermöglicht es einem Handler, die Änderung der Registerkarte abzubrechen.

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

Ereignistyp

TabControlCancelEventHandler

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des Ereignisses Selecting . Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis eintritt, und kann Sie beim Debuggen unterstützen. Um über mehrere Ereignisse oder ereignisse zu berichten, die häufig auftreten, sollten Sie die Nachricht durch Console.WriteLine ein mehrlineiges TextBoxersetzen MessageBox.Show oder anfügen.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine instance des Typs TabControl enthältTabControl1. Stellen Sie dann sicher, dass der Ereignishandler dem Selecting Ereignis zugeordnet ist.

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

Hinweise

Wenn sich die aktuelle Registerkarte in einem TabControländert, treten die folgenden Ereignisse in der folgenden Reihenfolge auf.

Mit diesen Ereignissen können Sie Aufgaben ausführen, z. B. das Abbrechen einer Registerkartenänderung, wenn sich ein TabPage in einem ungültigen Zustand befindet, oder das Aktualisieren des Zustands eines neu angezeigten TabPage.

Die aktuelle Registerkarte ändert sich, wenn der Benutzer auf eine Registerkarte klickt, wenn Sie die DeselectTab -Methode oder SelectTab aufrufen oder den Wert der SelectedIndex -Eigenschaft oder SelectedTab ändern.

Gilt für:

Weitere Informationen