TabControl.Selecting イベント

定義

タブが選択される前に発生し、ハンドラーがタブの変更をキャンセルできるようにします。Occurs before a tab is selected, enabling a handler to cancel the tab change.

public:
 event System::Windows::Forms::TabControlCancelEventHandler ^ Selecting;
public event System.Windows.Forms.TabControlCancelEventHandler Selecting;
member this.Selecting : System.Windows.Forms.TabControlCancelEventHandler 
Public Custom Event Selecting As TabControlCancelEventHandler 

このメンバーの使用例を次のコード例に示します。The following code example demonstrates the use of this member. この例では、イベントハンドラーがSelectingイベントの発生を報告します。In the example, an event handler reports on the occurrence of the Selecting event. このレポートは、イベントがいつ発生し、デバッグに役立つかを理解するのに役立ちます。This report helps you to learn when the event occurs and can assist you in debugging. 複数のイベントまたは頻繁に発生するイベントについてレポートMessageBox.ShowするConsole.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. 次に、イベントハンドラーがSelectingイベントに関連付けられていることを確認します。Then ensure that the event handler is associated with the Selecting event.

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

注釈

で現在のタブが変更さ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.

適用対象

こちらもご覧ください