TabControl.Selecting Událost

Definice

Vyvolá se před výběrem karty a umožňuje obslužné rutině zrušit změnu 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 

Event Type

Příklady

Následující příklad kódu ukazuje použití tohoto členu. V příkladu obslužná rutina události hlásí výskyt Selecting události. Tato sestava vám pomůže zjistit, kdy k události dojde, a může vám pomoct s laděním. Pokud chcete hlásit více událostí nebo událostí, ke kterým dochází často, zvažte nahrazení MessageBox.ShowConsole.WriteLine nebo připojení zprávy k víceřádkovému TextBoxobjektu .

Pokud chcete spustit ukázkový kód, vložte ho do projektu, který obsahuje instanci typu TabControl s názvem TabControl1. Pak se ujistěte, že je obslužná rutina události přidružená k Selecting události.

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

Poznámky

Když se aktuální karta změní v TabControl, dojde k následujícím událostem v následujícím pořadí.

Tyto události umožňují provádět úlohy, jako je zrušení změny karty, pokud TabPage je objekt v neplatném stavu, nebo aktualizaci stavu nově zobrazeného objektu TabPage.

Aktuální karta se změní, když uživatel klikne na kartu, když zavoláte metodu DeselectTab nebo SelectTab nebo když změníte hodnotu SelectedIndex vlastnosti nebo SelectedTab .

Platí pro

Viz také