TabControl.Selected Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre quando uma guia é selecionada.
public:
event System::Windows::Forms::TabControlEventHandler ^ Selected;
public event System.Windows.Forms.TabControlEventHandler Selected;
public event System.Windows.Forms.TabControlEventHandler? Selected;
member this.Selected : System.Windows.Forms.TabControlEventHandler
Public Custom Event Selected As TabControlEventHandler
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 Selected 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 Selected evento.
private void TabControl1_Selected(Object sender, TabControlEventArgs 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();
MessageBox.Show(messageBoxCS.ToString(), "Selected Event" );
}
Private Sub TabControl1_Selected(sender as Object, e as TabControlEventArgs) _
Handles TabControl1.Selected
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()
MessageBox.Show(messageBoxVB.ToString(),"Selected 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.