TabControl.Deselecting TabControl.Deselecting TabControl.Deselecting TabControl.Deselecting Event

定义

在取消选择某个选项卡之前发生,使处理程序能够取消选项卡更改。Occurs before a tab is deselected, enabling a handler to cancel the tab change.

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 

示例

下面的代码示例演示如何使用此成员。The following code example demonstrates the use of this member. 在此示例中, 事件处理程序报告Deselecting事件的发生。In the example, an event handler reports on the occurrence of the Deselecting event. 此报表可帮助你了解何时发生事件, 并可帮助你进行调试。This report helps you to learn when the event occurs and can assist you in debugging. 若要报告多个事件或频繁发生的事件, 请考虑MessageBox.ShowConsole.WriteLine消息替换为多行或将TextBox其追加到多行。To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

若要运行示例代码, 请将其粘贴到包含名为TabControl TabControl1的类型的实例的项目中。To run the example code, paste it into a project that contains an instance of type TabControl named TabControl1. 然后, 确保事件处理程序与Deselecting事件相关联。Then ensure that the event handler is associated with the Deselecting event.

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

注解

当当前选项卡在中TabControl更改时,以下事件将按以下顺序发生。When the current tab changes in a TabControl, the following events occur in the following order.

如果TabPage处于无效状态或更新新显示TabPage的状态,这些事件可以让你执行一些任务,如取消选项卡更改。These events let you perform tasks such as canceling a tab change if a TabPage is in an invalid state or updating the state of a newly displayed TabPage.

当用户单击某个选项卡、 DeselectTab调用或SelectTab方法时,或者当你SelectedIndex更改或SelectedTab属性的值时,当前选项卡会发生更改。The current tab changes when the user clicks a tab, when you call the DeselectTab or SelectTab method, or when you change the value of the SelectedIndex or SelectedTab property.

适用于

另请参阅