TabControlCancelEventArgs Classe

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

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 saber 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 por 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 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 para determinar para qual TabPage 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 lidar com eventos, consulte Manipulando e gerando eventos.

Construtores

TabControlCancelEventArgs(TabPage, Int32, Boolean, TabControlAction)

Inicializa uma nova instância da classe TabControlCancelEventArgs.

Propriedades

Action

Obtém um valor que indica qual evento está ocorrendo.
Cancel

Obtém ou define um valor que indica se o evento deve ser cancelado.

(Herdado de CancelEventArgs)
TabPage

Obtém o TabPage para o qual o evento está ocorrendo.
TabPageIndex

Obtém o índice baseado em zero do TabPage na coleção TabPages.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também