TabControl.Deselecting Evento

Definición

Aparece antes de que se anule la selección de una ficha, permitiendo que un controlador cancele el cambio de ficha.Occurs before a tab is deselected, enabling a handler to cancel the tab change.

public:
 event System::Windows::Forms::TabControlCancelEventHandler ^ Deselecting;
public event System.Windows.Forms.TabControlCancelEventHandler Deselecting;
member this.Deselecting : System.Windows.Forms.TabControlCancelEventHandler 
Public Custom Event Deselecting As TabControlCancelEventHandler 

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este miembro.The following code example demonstrates the use of this member. En el ejemplo, un controlador de eventos informa sobre la aparición del evento Deselecting.In the example, an event handler reports on the occurrence of the Deselecting event. Este informe le ayuda a saber cuándo se produce el evento y puede ayudarle a depurar.This report helps you to learn when the event occurs and can assist you in debugging. Para notificar varios eventos o eventos que se producen con frecuencia, considere la posibilidad de reemplazar MessageBox.Show por Console.WriteLine o anexar el mensaje a un TextBoxmultilínea.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Para ejecutar el código de ejemplo, péguelo en un proyecto que contenga una instancia de tipo TabControl denominada TabControl1.To run the example code, paste it into a project that contains an instance of type TabControl named TabControl1. A continuación, asegúrese de que el controlador de eventos está asociado al evento Deselecting.Then ensure that the event handler is associated with the Deselecting event.

private void TabControl1_Deselecting(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(), "Deselecting Event" );
}
Private Sub TabControl1_Deselecting(sender as Object, e as TabControlCancelEventArgs) _ 
     Handles TabControl1.Deselecting

    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(),"Deselecting Event")

End Sub

Comentarios

Cuando la pestaña actual cambia en un TabControl, se producen los siguientes eventos en el orden siguiente.When the current tab changes in a TabControl, the following events occur in the following order.

Estos eventos permiten realizar tareas como cancelar un cambio de tabulación si un TabPage está en un estado no válido o actualizar el estado de un TabPageque se acaba de mostrar.These events let you perform tasks such as canceling a tab change if a TabPage is in an invalid state or updating the state of a newly displayed TabPage.

La pestaña actual cambia cuando el usuario hace clic en una pestaña, cuando se llama al método DeselectTab o SelectTab, o cuando se cambia el valor de la propiedad SelectedIndex o SelectedTab.The current tab changes when the user clicks a tab, when you call the DeselectTab or SelectTab method, or when you change the value of the SelectedIndex or SelectedTab property.

Se aplica a

Consulte también: