バージョン

MdiTabSettings クラス

MdiTab のデフォルト設定可能なプロパティ設定を保持します。
シンタックス
'宣言
 
Public Class MdiTabSettings 
   Inherits Infragistics.Shared.SubObjectBase
public class MdiTabSettings : Infragistics.Shared.SubObjectBase
解説

MdiTabSettings オブジェクトは、MdiTab オブジェクトの外観と動作に影響を与えるために使用されます。値はデフォルト値で初期化されます。これらのデフォルト値は MdiTabSettingsResolved インスタンスによって解決されます。このインスタンスには MdiTab.SettingsResolved プロパティを使用して MdiTab からアクセスできます。

このクラスで最もよく使用されるプロパティは外観プロパティです。これらのプロパティはタブ項目の外観を制御するために使用されます。このクラスは４種類のタブの外観を公開しています。TabAppearance プロパティは、タブのデフォルトの外観を決定するために使用されます。通常は、タブの状態にかかわらず、タブに特定のイメージが表示されるようにするため、このプロパティにImageプロパティが設定されます。SelectedTabAppearance は、タブが自身の含まれている MdiTabGroup 内の MdiTabGroup.SelectedTab であるときに、タブの外観を補強するために使用されます。タブが選択されていないときには、この外観の値は使用されません。ActiveTabAppearance は、タブが選択されていなければならないという点で SelectedTabAppearance と似ています。しかし、アクティブな MDI の子がたった１つしかないのと同様に、UltraTabbedMdiManager.ActiveTab も１つしかありません。アクティブタブは選択されている必要があるため、タブグループが１つしか存在しない場合は、選択されたタブがアクティブタブになります。しかし、UltraTabbedMdiManager.TabGroups コレクションに複数のタブグループが存在する場合は、たった１つのタブグループにのみアクティブタブが含まれることになります。そのアクティブタブの外観がActiveTabAppearanceによって制御されます。最後の外観プロパティは HotTrackTabAppearance です。この外観は、マウスがタブ項目の上にあるときの外観解決プロセスで、HotTrack プロパティがTrueに解決された場合に使用されます。

このクラスには、タブの動作に作用するプロパティがいくつかあります。AllowDrag プロパティは、タブの位置を変更できるかどうかと、どこに変更できるかを決定するために使用します。AllowClose は、タブが選択されているときに閉じるボタンを有効にするかどうかを決定します。TabCloseAction は、タブを閉じたときに実行されるアクションを決定します。

注意：タブ項目のサイズを決定する際に使用されるのは、UltraTabbedMdiManager.TabSettings および TabSettings のタブの外観のフォント情報のみです。Settings で設定されたフォント情報は、表示には作用しますが、MdiTabGroup のサイズの決定には使用されません。

使用例
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinTabs
Imports Infragistics.Win.UltraWinTabbedMdi

Private Sub InitializeTabbedMdi(ByVal mdiManager As UltraTabbedMdiManager)
    ' the same type (MdiTabSettings) is used for the 
    ' TabSettings of the UltraTabbedMdiManager - affects all tabs
    ' TabSettings of the MdiTabGroup - affects all tabs in group
    ' Settings of the MdiTab - affects the specific tab
    Me.InitializeTabSettings(mdiManager.TabSettings)

    ' the same type (MdiTabGroupSettings) is used for the 
    ' TabGroupSettings of the UltraTabbedMdiManager - affects all tab groups
    ' Settings of the MdiTabGroup - affects the specific tab group
    Me.InitializeTabGroupSettings(mdiManager.TabGroupSettings)
End Sub

Private Sub InitializeTabSettings(ByVal tabSettings As MdiTabSettings)
    ' allow tabs contained in the tab group to being closed
    tabSettings.AllowClose = DefaultableBoolean.True

    ' close the associated form when the close
    ' button is pressed
    tabSettings.TabCloseAction = MdiTabCloseAction.Close

    ' only allow tabs to be repositioned within its containing group
    tabSettings.AllowDrag = MdiTabDragStyle.WithinGroup

    ' do not use the icon of the associated for as
    ' the image for the tab
    tabSettings.DisplayFormIcon = DefaultableBoolean.False

    ' enable hot tracking - the tab will make use
    ' of the hot track appearance when the mouse is
    ' over the tab
    tabSettings.HotTrack = DefaultableBoolean.True

    ' when the mouse is over the tab, the forecolor
    ' should use the system's hot track color
    tabSettings.HotTrackTabAppearance.ForeColor = SystemColors.HotTrack

    ' when the tab is selected, use the system colors button
    ' colors
    tabSettings.SelectedTabAppearance.BackColor = SystemColors.ControlDarkDark
    tabSettings.SelectedTabAppearance.ForeColor = SystemColors.ControlLightLight
End Sub

Private Sub InitializeTabGroupSettings(ByVal groupSettings As MdiTabGroupSettings)
    ' display the close button in the tab group
    groupSettings.ShowCloseButton = DefaultableBoolean.True

    ' enable the automatic selection of a tab when the mouse
    ' is over a tab for a specific period of time
    groupSettings.AutoSelect = DefaultableBoolean.True

    ' wait 2 seconds when the mouse enters
    ' the bounds of the tab before it is selected automatically
    groupSettings.AutoSelectDelay = 0

    ' do not allow a tab's width to exceed 200 pixels
    groupSettings.MaxTabWidth = 200

    ' do not allow a tab's width to be less than 50 pixels
    groupSettings.MinTabWidth = 50

    ' put 2 pixels of padding around the image and text area
    groupSettings.TabPadding = New Size(2, 2)

    ' have the tabs aligned to the bottom of the tab group
    groupSettings.TabOrientation = TabOrientation.BottomLeft

    ' have the tab's size based on their image and text but
    ' they will be constrained to the limits set above
    groupSettings.TabSizing = TabSizing.AutoSize

    ' use worksheet style tabs
    groupSettings.TabStyle = TabStyle.Excel
End Sub
using Infragistics.Win;
using Infragistics.Win.UltraWinTabs;
using Infragistics.Win.UltraWinTabbedMdi;

private void InitializeTabbedMdi(UltraTabbedMdiManager mdiManager)
{
	// the same type (MdiTabSettings) is used for the 
	// TabSettings of the UltraTabbedMdiManager - affects all tabs
	// TabSettings of the MdiTabGroup - affects all tabs in group
	// Settings of the MdiTab - affects the specific tab
	this.InitializeTabSettings(mdiManager.TabSettings);

	// the same type (MdiTabGroupSettings) is used for the 
	// TabGroupSettings of the UltraTabbedMdiManager - affects all tab groups
	// Settings of the MdiTabGroup - affects the specific tab group
	this.InitializeTabGroupSettings(mdiManager.TabGroupSettings);
}

private void InitializeTabSettings( MdiTabSettings tabSettings )
{
	// allow tabs contained in the tab group to being closed
	tabSettings.AllowClose = DefaultableBoolean.True;

	// close the associated form when the close
	// button is pressed
	tabSettings.TabCloseAction = MdiTabCloseAction.Close;

	// only allow tabs to be repositioned within its containing group
	tabSettings.AllowDrag = MdiTabDragStyle.WithinGroup;

	// do not use the icon of the associated for as
	// the image for the tab
	tabSettings.DisplayFormIcon = DefaultableBoolean.False;

	// enable hot tracking - the tab will make use
	// of the hot track appearance when the mouse is
	// over the tab
	tabSettings.HotTrack = DefaultableBoolean.True;

	// when the mouse is over the tab, the forecolor
	// should use the system's hot track color
	tabSettings.HotTrackTabAppearance.ForeColor = SystemColors.HotTrack;

	// when the tab is selected, use the system colors button
	// colors
	tabSettings.SelectedTabAppearance.BackColor = SystemColors.ControlDarkDark;
	tabSettings.SelectedTabAppearance.ForeColor = SystemColors.ControlLightLight;
}

private void InitializeTabGroupSettings( MdiTabGroupSettings groupSettings )
{
	// display the close button in the tab group
	groupSettings.ShowCloseButton = DefaultableBoolean.True;

	// enable the automatic selection of a tab when the mouse
	// is over a tab for a specific period of time
	groupSettings.AutoSelect = DefaultableBoolean.True;

	// wait 2 seconds when the mouse enters
	// the bounds of the tab before it is selected automatically
	groupSettings.AutoSelectDelay = 0;

	// do not allow a tab's width to exceed 200 pixels
	groupSettings.MaxTabWidth = 200;

	// do not allow a tab's width to be less than 50 pixels
	groupSettings.MinTabWidth = 50;

	// put 2 pixels of padding around the image and text area
	groupSettings.TabPadding = new Size(2,2);

	// have the tabs aligned to the bottom of the tab group
	groupSettings.TabOrientation = TabOrientation.BottomLeft;

	// have the tab's size based on their image and text but
	// they will be constrained to the limits set above
	groupSettings.TabSizing = TabSizing.AutoSize;

	// use worksheet style tabs
	groupSettings.TabStyle = TabStyle.Excel;
}
参照