Questa documentazione è stata archiviata e non viene gestita.

Evento TabControl.Selecting

Aggiornamento: novembre 2007

Si verifica se viene selezionata una scheda, attivando un gestore per l'annullamento della modifica della scheda.

Spazio dei nomi:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public event TabControlCancelEventHandler Selecting
/** @event */
public void add_Selecting (TabControlCancelEventHandler value)
/** @event */
public void remove_Selecting (TabControlCancelEventHandler value)

JScript non supporta gli eventi.

Se la scheda corrente viene modificata in un controllo TabControl, si verificano i seguenti eventi nel seguente ordine.

Questi eventi consentono di eseguire operazioni come l'annullamento della modifica di una scheda se un controllo TabPage è in uno stato non valido oppure l'aggiornamento dello stato di un controllo TabPage appena visualizzato.

La scheda corrente viene modificata se l'utente fa clic su una scheda, se viene chiamato il metodo DeselectTab o SelectTab oppure se viene modificato il valore della proprietà SelectedIndex o SelectedTab.

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo di questo membro. Nell'esempio, un gestore eventi genera report sull'occorrenza dell'evento Selecting. Questo report consente di capire quando si verifica l'evento offrendo un supporto per il debug. Per generare report su più eventi o su eventi che si verificano frequentemente, sostituire MessageBox.Show con Console.WriteLine o aggiungere il messaggio a un controllo TextBox su più righe.

Per eseguire il codice di esempio, incollarlo in un progetto che contenga un'istanza di tipo TabControl denominata TabControl1. Assicurarsi quindi che il gestore eventi sia associato all'evento 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" );
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0, 2.0
Mostra: