Esta documentación está archivada y no tiene mantenimiento.

TabControl.Deselecting (Evento)

Actualización: noviembre 2007

Aparece antes de que se anule la selección de una ficha, permitiendo que un controlador cancele el cambio de ficha.

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

public event TabControlCancelEventHandler Deselecting
/** @event */
public void add_Deselecting (TabControlCancelEventHandler value)
/** @event */
public void remove_Deselecting (TabControlCancelEventHandler value)

JScript no admite eventos.

Si la ficha actual cambia en un control TabControl, se producen los siguientes eventos, en este orden.

Estos eventos permiten realizar tareas como cancelar el cambio de una ficha si un objeto TabPage está en un estado no válido, o actualizar el estado de un objeto TabPage recién mostrado.

La ficha actual cambia si un usuario hace clic en una ficha, si se llama al método DeselectTab o SelectTab, o si se cambia el valor de la propiedad SelectedIndex o SelectedTab.

En el ejemplo de código siguiente se muestra el uso de este miembro. En el ejemplo, un controlador de eventos notifica que se ha producido el evento Deselecting. Este informe es útil para saber cuándo se produce el evento y puede servir de ayuda en la depuración. Para informar sobre varios eventos o sobre eventos que se producen frecuentemente, considere la posibilidad de reemplazar MessageBox.Show por Console.WriteLine o de agregar el mensaje a un TextBox de varias líneas.

Para ejecutar el código de ejemplo, péguelo en un proyecto que contenga una instancia de tipo TabControl con la denominación TabControl1. A continuación, asegúrese de que el controlador de eventos esté asociado al evento Deselecting.

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


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 y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0
Mostrar: