TabControlCancelEventArgs Classe

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

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

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 seguinte exemplo de código demonstra o uso deste tipo. No exemplo, um gestor de eventos reporta a ocorrência do Selecting evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o num projeto que contenha uma instância do tipo TabControl chamada TabControl1. Depois, certifique-se de que o gestor 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

Observações

Use a Action propriedade para determinar qual evento está a ocorrer. Isto permite-lhe gerir vários tipos de eventos com um único gestor de eventos.

Use as TabPage propriedades e TabPageIndex para determinar para qual TabPage o evento está a ocorrer.

Para cancelar uma alteração de tabulação num TabControl, defina a Cancel propriedade para true.

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

Construtores

Name Description
TabControlCancelEventArgs(TabPage, Int32, Boolean, TabControlAction)

Inicializa uma nova instância da TabControlCancelEventArgs classe.

Propriedades

Name Description
Action

Recebe um valor que indica qual evento está a ocorrer.
Cancel

Recebe ou define um valor que indica se o evento deve ser cancelado.

(Herdado de CancelEventArgs)
TabPage

Percebe o TabPage que o evento está a decorrer.
TabPageIndex

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

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também