StoreTab イベント

各タブの PersistedInfo を初期化できるように、SaveAsBinary(Stream) メソッドまたは SaveAsXml(Stream) メソッドが起動されるときに発生するイベント。

シンタックス

Visual Basic

'宣言
 
Public Event StoreTab As StoreTabEventHandler

C#

public event StoreTabEventHandler StoreTab

イベント データ

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

プロパティ	解説
Tab Infragistics.Win.UltraWinTabbedMdi.MdiTabEventArgsから継承されます。	関連付けられた MdiTab を返します。

解説

StoreTab イベントは、SaveAsXml(Stream) メソッドまたは SaveAsBinary(Stream) メソッドが呼び出される時に MdiTab ごとに起動されます。このイベントの目的は、タブをシリアル化する前に PersistedInfo プロパティを初期化する機会を提供することです。PersistedInfo プロパティはこのイベントの外部で設定できますが、逆シリアル化時に適切なフォームを作成するために必要な基準が、アプリケーションの存続期間を通じて変わることがよくあります。このイベントを使用すると、シリアル化の直前に、すべての TabGroups と HiddenTabs の Tabs を繰り返さずにタブを一箇所で初期化できます。

使用例

Visual Basic

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

Private Sub ultraTabbedMdiManager1_StoreTab(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinTabbedMdi.StoreTabEventArgs) Handles ultraTabbedMdiManager1.StoreTab
    ' The 'StoreTab' event is invoked when the SaveAsXml or 
    ' SaveAsBinary method is invoked. It is a convenient place 
    ' to initialize the 'PersistedInfo' property of the tabs 
    ' immediately prior to serialization and is invoked once for 
    ' each MdiTab in the TabGroups and in the HiddenTabs. This 
    ' will prevent the need to keep updating the PersistedInfo 
    ' at other points when the information needed to deserialize 
    ' the tab changes - e.g. when the file name of the associated 
    ' form changes.

    If TypeOf e.Tab.Form Is EditForm Then
        e.Tab.PersistedInfo = (CType(e.Tab.Form, EditForm)).FileName
    Else
        e.Tab.PersistedInfo = e.Tab.Form.Text
    End If
End Sub

C#

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

private void ultraTabbedMdiManager1_StoreTab(object sender, Infragistics.Win.UltraWinTabbedMdi.StoreTabEventArgs e)
{
	// The 'StoreTab' event is invoked when the SaveAsXml or 
	// SaveAsBinary method is invoked. It is a convenient place 
	// to initialize the 'PersistedInfo' property of the tabs 
	// immediately prior to serialization and is invoked once for 
	// each MdiTab in the TabGroups and in the HiddenTabs. This 
	// will prevent the need to keep updating the PersistedInfo 
	// at other points when the information needed to deserialize 
	// the tab changes - e.g. when the file name of the associated 
	// form changes.

	if (e.Tab.Form is EditForm)
		e.Tab.PersistedInfo = ((EditForm)e.Tab.Form).FileName;
	else
		e.Tab.PersistedInfo = e.Tab.Form.Text;
}