TabControl.Selecting Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica prima che venga selezionata una scheda, consentendo a un gestore di annullare la modifica della scheda.
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 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 di facilitare il debug. Per segnalare più eventi o eventi che si verificano frequentemente, è consigliabile sostituire MessageBox.Show con Console.WriteLine o 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 .
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
Commenti
Quando la scheda corrente cambia in un TabControloggetto , si verificano gli eventi seguenti nell'ordine seguente.
Questi eventi consentono di eseguire attività quali l'annullamento di una modifica della scheda se un oggetto TabPage 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 .
