Compartilhar via


TabControl.Deselecting Evento

Definição

Ocorre antes que uma guia seja desmarcada, permitindo que um manipulador cancele a mudança de guia.

public:
 event System::Windows::Forms::TabControlCancelEventHandler ^ Deselecting;
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 

Tipo de evento

Exemplos

O exemplo de código a seguir demonstra o uso desse membro. No exemplo, um manipulador de eventos relata a ocorrência do Deselecting evento. Este relatório ajuda você a aprender quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.ShowConsole.WriteLine ou acrescentar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o em um projeto que contém uma instância do tipo TabControl chamada TabControl1. Em seguida, verifique se o manipulador de eventos está associado ao Deselecting evento.

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

Comentários

Quando a guia atual é alterada em um TabControl, os eventos a seguir ocorrem na seguinte ordem.

Estes eventos permitem executar tarefas como cancelar uma mudança de guia caso TabPage seja um estado inválido ou atualizar o estado de um TabPage recém-exibido.

A guia atual é alterada quando o usuário clica em uma guia, quando você chama o método DeselectTab ou SelectTab ou quando você altera o valor da propriedade SelectedIndex ou SelectedTab.

Aplica-se a

Confira também