TabGroupResizing イベント

MdiTabGroup のサイズが変更される前に発生するキャンセル可能なイベント。

シンタックス

Visual Basic

'宣言
 
Public Event TabGroupResizing As MdiTabGroupResizingEventHandler

C#

public event MdiTabGroupResizingEventHandler TabGroupResizing

イベント データ

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

プロパティ	解説
Cancel System.ComponentModel.CancelEventArgsから継承されます。
TabGroups	サイズ変更される MdiTabGroup オブジェクトのコレクションを返します。

解説

TabGroupResizing は、1 つまたは複数の MdiTabGroup オブジェクトの Extent が変更される直前に呼び出されます。これは、スプリッターのドラッグ (SplitterDragging)、MDI クライアントのサイズ変更、新しい MdiTabGroupの作成、既存の MdiTabGroup の削除、Extent または ClientExtent 明示的な設定の結果として起こります。

範囲の合計は MDI クライアントのクライアント領域の範囲と常に一致している必要があります。幅と高さのどちらが一致する必要があるかは Orientation によって決まります。このイベントがキャンセルされた場合、範囲の合計は計算されません。合計が MDI クライアント領域の範囲と一致しない場合は、範囲が調整されます。

注: Extent を設定すると、このイベントは暗黙的にキャンセルされ、タブグループの範囲が上で説明したように検証されます。

使用例

Visual Basic

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

Private Sub ultraTabbedMdiManager1_TabGroupResizing(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinTabbedMdi.MdiTabGroupResizingEventArgs) Handles ultraTabbedMdiManager1.TabGroupResizing
    ' The 'TabGroupResizing' event is invoked before the 
    ' Extent of one or more MdiTabGroups is modified.
    '

    ' The 'Cancel' parameter may be set to true to 
    ' prevent the resize operation. Note, however that
    ' the sum of the extents must match the relative 
    ' client area of the mdi client so if the resize operation
    ' came as a result of resizing the mdi client for example,
    ' the sizes must still be updated.
    '
    'e.Cancel = True

    Dim sb As System.Text.StringBuilder = New System.Text.StringBuilder()

    sb.Append("TabGroupResizing:")

    ' The 'GetNewExtents' method will return an array of 
    ' integers indicating the proposed new size of the 
    ' the 'TabGroups'.
    'Dim newSizes As Integer() = e.GetNewExtents()

    Dim i As Integer
    For i = 0 To e.TabGroups.Count - 1 Step +1
        ' The 'TabGroups' parameter returns a collection
        ' of one or more MdiTabGroup objects that will
        ' have its Extent modified.
        '
        Dim tabGroup As MdiTabGroup = e.TabGroups(i)

        ' The 'GetNewExtent' method will return the 
        ' proposed extent for the specified tab group.
        '
        Dim NewExtent As Integer = e.GetNewExtent(tabGroup)

        sb.AppendFormat(" [#{3}] TabGroup ({0}) being resized from {1} to {2};", tabGroup, tabGroup.Extent, NewExtent, i)
    Next

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

C#

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

private void ultraTabbedMdiManager1_TabGroupResizing(object sender, Infragistics.Win.UltraWinTabbedMdi.MdiTabGroupResizingEventArgs e)
{
	// The 'TabGroupResizing' event is invoked before the 
	// Extent of one or more MdiTabGroups is modified.
	//

	// The 'Cancel' parameter may be set to true to 
	// prevent the resize operation. Note, however that
	// the sum of the extents must match the relative 
	// client area of the mdi client so if the resize operation
	// came as a result of resizing the mdi client for example,
	// the sizes must still be updated.
	//
	// e.Cancel = true;

	System.Text.StringBuilder sb = new System.Text.StringBuilder();

	sb.Append("TabGroupResizing:");

	// The 'GetNewExtents' method will return an array of 
	// integers indicating the proposed new size of the 
	// the 'TabGroups'.
	//int[] newSizes = e.GetNewExtents();

	for(int i = 0; i < e.TabGroups.Count; i++)
	{
		// The 'TabGroups' parameter returns a collection
		// of one or more MdiTabGroup objects that will
		// have its Extent modified.
		//
		MdiTabGroup tabGroup = e.TabGroups[i];

		// The 'GetNewExtent' method will return the 
		// proposed extent for the specified tab group.
		//
		int newExtent = e.GetNewExtent(tabGroup);

		sb.AppendFormat( " [#{3}] TabGroup ({0}) being resized from {1} to {2};", tabGroup, tabGroup.Extent, newExtent, i);
	}

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