TabSelecting イベント

MdiTab が選択される前に発生するキャンセル可能なイベント。

シンタックス

Visual Basic

'宣言
 
Public Event TabSelecting As CancelableMdiTabEventHandler

C#

public event CancelableMdiTabEventHandler TabSelecting

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、CancelableMdiTabEventArgs 型の引数を受け取りました。次の CancelableMdiTabEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	解説
Cancel System.ComponentModel.CancelEventArgsから継承されます。
Tab	関連付けられた MdiTab を返します。

解説

MdiTabGroup.SelectedTab が変更されようとする時に TabSelecting が起動されます。MdiTab を選択すると、関連付けられている Form がアクティブ化されます。

ActiveTab はアクティブな MDI タブを表し、MDI 子フォームのアクティブ化はフォームの Z オーダーによって維持されるため、ActiveTab はその TabGroup の MdiTabGroup.SelectedTab でなければなりません。ActiveTabは選択されなければならないため、ActiveTab が変更されると TabSelectingイベントが呼び出されます。

注: アクティブ化/選択は外部アクションの結果として起こることがあるため (たとえば、MDI の子が初めて作成されたときなど) 、TabSelecting イベントは常にキャンセルできるとは限りません。

使用例

Visual Basic

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinTabs
Imports Infragistics.Win.UltraWinTabbedMdi

Private Sub ultraTabbedMdiManager1_TabSelecting(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinTabbedMdi.CancelableMdiTabEventArgs) Handles ultraTabbedMdiManager1.TabSelecting
    ' The 'TabSelecting' event is invoked when a tab is about to 
    ' be selected in an MdiTabGroup.
    '

    ' The 'Cancel' parameter may be set to true to 
    ' prevent the selection operation from occuring.
    ' Note, there are times when the activation of a tab 
    ' is initiated externally, e.g. when a new mdi child
    ' is created, that the event may not be cancellable.
    '
    'e.Cancel = True

    ' The 'Tab' parameter returns the MdiTab instance that 
    ' will be selected.
    Dim sb As System.Text.StringBuilder = New System.Text.StringBuilder()

    sb.Append("TabSelecting:")

    sb.AppendFormat("Tab ['{0}'] will be selected.", e.Tab)
    sb.AppendFormat(" The current selected tab in tab group ['{0}'] is '{1}'", e.Tab.TabGroup, e.Tab.TabGroup.SelectedTab)

    System.Diagnostics.Debug.WriteLine(sb.ToString())
End Sub

C#

using Infragistics.Win;
using Infragistics.Win.UltraWinTabs;
using Infragistics.Win.UltraWinTabbedMdi;

private void ultraTabbedMdiManager1_TabSelecting(object sender, Infragistics.Win.UltraWinTabbedMdi.CancelableMdiTabEventArgs e)
{
	// The 'TabSelecting' event is invoked when a tab is about to 
	// be selected in an MdiTabGroup.
	//

	// The 'Cancel' parameter may be set to true to 
	// prevent the selection operation from occuring.
	// Note, there are times when the activation of a tab 
	// is initiated externally, e.g. when a new mdi child
	// is created, that the event may not be cancellable.
	//
	//e.Cancel = true;

	// The 'Tab' parameter returns the MdiTab instance that 
	// will be selected.
	System.Text.StringBuilder sb = new System.Text.StringBuilder();

	sb.Append("TabSelecting:");

	sb.AppendFormat("Tab ['{0}'] will be selected.", e.Tab);
	sb.AppendFormat(" The current selected tab in tab group ['{0}'] is '{1}'", e.Tab.TabGroup, e.Tab.TabGroup.SelectedTab);

	System.Diagnostics.Debug.WriteLine(sb.ToString());
}