TabControl.Selecting Zdarzenie
Definicja
Ważny
Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.
Występuje przed wybraniem karty, umożliwiając programowi obsługi anulowanie zmiany karty.
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 Typ wydarzenia
Przykłady
W poniższym przykładzie kodu pokazano użycie tego elementu członkowskiego. W tym przykładzie program obsługi zdarzeń zgłasza wystąpienie Selecting zdarzenia. Ten raport pomaga dowiedzieć się, kiedy wystąpi zdarzenie, i może pomóc w debugowaniu. Aby zgłosić wiele zdarzeń lub często występujących zdarzeń, rozważ zastąpienie MessageBox.Show komunikatu ciągiem Console.WriteLine lub dołączenie go do wielowierszowego TextBoxelementu .
Aby uruchomić przykładowy kod, wklej go w projekcie zawierającym wystąpienie typu TabControl o nazwie TabControl1. Następnie upewnij się, że program obsługi zdarzeń jest skojarzony ze zdarzeniem Selecting .
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
Uwagi
Gdy bieżąca karta zmieni się w elemencie TabControl, następujące zdarzenia występują w następującej kolejności.
Te zdarzenia umożliwiają wykonywanie zadań, takich jak anulowanie zmiany karty, jeśli TabPage element jest w nieprawidłowym stanie lub aktualizowanie stanu nowo wyświetlonego TabPageelementu .
Bieżąca karta zmienia się po kliknięciu karty przez użytkownika, wywołaniu DeselectTab metody lub SelectTab zmianie wartości SelectedIndex właściwości lub SelectedTab .
