TabControl.Selecting Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.