TabControlCancelEventArgs Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

TabControlCancelEventArgs.cs

Fornece dados para os eventos e Selecting eventos Deselecting de um TabControl controle.

public ref class TabControlCancelEventArgs : System::ComponentModel::CancelEventArgs

public class TabControlCancelEventArgs : System.ComponentModel.CancelEventArgs

type TabControlCancelEventArgs = class
    inherit CancelEventArgs

Public Class TabControlCancelEventArgs
Inherits CancelEventArgs

Herança

Object

EventArgs

CancelEventArgs

TabControlCancelEventArgs

Exemplos

O exemplo de código a seguir demonstra o uso desse tipo. No exemplo, um manipulador de eventos relata a ocorrência do Selecting 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 ShowConsole.WriteLine ou acrescentar a mensagem a uma linha TextBoxmúltipla.

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

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

Comentários

Use a Action propriedade para determinar qual evento está ocorrendo. Isso permite que você manipule vários tipos de eventos com um manipulador de eventos.

Use as TabPage propriedades e TabPageIndex as propriedades para as quais TabPage o evento está ocorrendo.

Para cancelar uma alteração de guia em um TabControl, defina a Cancel propriedade como true.

Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.

Construtores

Nome	Description
TabControlCancelEventArgs(TabPage, Int32, Boolean, TabControlAction)	Inicializa uma nova instância da classe TabControlCancelEventArgs.

Propriedades

Nome	Description
Action	Obtém um valor que indica qual evento está ocorrendo.
TabPage	Obtém o TabPage evento para o qual o evento está ocorrendo.
TabPageIndex	Obtém o índice baseado em TabPages zero da TabPage coleção.

Confira também

• TabControl
• Selecting
• Deselecting
• Action
• TabPage
• TabPageIndex
• Cancel