Freigeben über


TabControl.Selecting Ereignis

Definition

Tritt auf, bevor eine Registerkarte ausgewählt wird, wodurch ein Handler zum Abbrechen der Registerkartenänderung aktiviert wird.

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

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Elements veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des Selecting Ereignisses. Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis auftritt und Sie beim Debuggen unterstützen kann. Wenn Sie über mehrere Ereignisse oder ereignisse berichten möchten, die häufig auftreten, erwägen Sie, die Nachricht durch MessageBox.Show eine mehrteilige Console.WriteLineNachricht zu ersetzen TextBox oder sie anzufügen.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine Instanz des Typs TabControl namens TabControl1enthält. 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 Ungültiger Zustand befindet oder der Status eines neu angezeigten TabPageObjekts aktualisiert wird.

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

Gilt für:

Weitere Informationen