TabControl.Selecting Evento

Definizione

Si verifica prima che una scheda venga selezionata, consentendo a un gestore di annullare il cambio di scheda.

C#
public event System.Windows.Forms.TabControlCancelEventHandler Selecting;
C#
public event System.Windows.Forms.TabControlCancelEventHandler? Selecting;

Tipo evento

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo membro. Nell'esempio un gestore eventi segnala l'occorrenza dell'evento Selecting . Questo report consente di apprendere quando si verifica l'evento e può essere utile per il debug. Per segnalare più eventi o eventi che si verificano di frequente, provare a sostituire MessageBox.Show o Console.WriteLine accodare il messaggio a un oggetto multilinea TextBox.

Per eseguire il codice di esempio, incollarlo in un progetto contenente un'istanza di tipo TabControl denominata TabControl1. Assicurarsi quindi che il gestore eventi sia associato all'evento Selecting .

C#
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" );
}

Commenti

Quando la scheda corrente viene modificata in un TabControloggetto , si verificano gli eventi seguenti nell'ordine seguente.

Questi eventi consentono di eseguire attività come l'annullamento di una modifica di tabulazione se un TabPage oggetto si trova in uno stato non valido o aggiorna lo stato di un oggetto appena visualizzato TabPage.

La scheda corrente cambia quando l'utente fa clic su una scheda, quando si chiama il DeselectTab metodo o SelectTab o quando si modifica il valore della SelectedIndex proprietà o SelectedTab .

Si applica a

Prodotto Versioni
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Vedi anche