TabControl.Selecting イベント

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

タブが選択される前に発生し、ハンドラーがタブの変更をキャンセルできるようにします。

public:
 event System::Windows::Forms::TabControlCancelEventHandler ^ Selecting;
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

イベントの種類

TabControlCancelEventHandler

例

次のコード例では、このメンバーの使用方法を示します。 この例では、イベント ハンドラーがイベントの Selecting 発生を報告します。 このレポートは、イベントが発生したタイミングを知るのに役立ち、デバッグに役立ちます。 複数のイベントまたは頻繁に発生するイベントを報告するには、 を Console.WriteLine に置き換えるかMessageBox.Show、複数行TextBoxにメッセージを追加することを検討してください。

コード例を実行するには、 という名前TabControl1の型TabControlのインスタンスを含むプロジェクトに貼り付けます。 次に、イベント ハンドラーが イベントに関連付けられていることを確認します Selecting 。

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変更されると、次のイベントが次の順序で発生します。

これらのイベントを使用すると、 が無効な状態の場合 TabPage にタブ変更を取り消したり、新しく表示された TabPageの状態を更新したりするなどのタスクを実行できます。

現在のタブは、ユーザーがタブをクリックしたとき、または SelectTab メソッドを呼び出DeselectTabすとき、または プロパティまたは SelectedTab プロパティのSelectedIndex値を変更したときに変更されます。

適用対象

こちらもご覧ください