TabControl.Selecting Zdarzenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 zdarzenia
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 .
