MdiTabGroupSettings クラス

MdiTabGroup のデフォルト設定可能なプロパティ設定を保持します。

シンタックス

Visual Basic

'宣言
 
Public Class MdiTabGroupSettings 
   Inherits Infragistics.Shared.SubObjectBase

C#

public class MdiTabGroupSettings : Infragistics.Shared.SubObjectBase 

解説

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

最もよく使用されるプロパティは TabStyle と TabSizing です。TabStyle プロパティはタブ項目のルック アンド フィールを決定するために使用するプロパティで、タブ項目の境界線の形状をに影響を与えます。TabSizing プロパティは、タブ項目のサイズの計算方法を決定します。デフォルトでは、タブ項目のサイズは、タブのイメージとテキストを表示するために必要なスペースの量に基づいて設定されます。タブ項目が常に適度なサイズになるようにするため、MinTabWidth と MaxTabWidth を使用してサイズを制限することができます。

このクラスは、タブ領域 (タブ項目の背後にある領域) 、スクロール関連項目、タブリストボタン、および閉じるボタンの外観を制御するために使用できる外観プロパティをいくつか公開しています。タブ領域を変更するには、TabAreaAppearance を使用します。スクロール項目を変更するには、ScrollTrackAppearance (スクロールボックスとスクロールバートラックの外観を制御する ScrollButtonAppearance) と (スクロールボタンとスクロールボックスの外観を制御する) を使用します。CloseButtonAppearance は閉じるボタン (タブ グループ領域に "X" として表示される) の外観を制御します。TabListButtonAppearance はタブ リスト ボタン (タブ グループ領域に下矢印インジケーターとして表示される) の外観を制御します。

このクラスには、タブ項目のレイアウトを操作するプロパティもあります。TabOrientation は、タブ項目が表示される領域を決定します。デフォルトでは、タブ項目は上に配置され、左から右にレイアウトされます。このプロパティを使用すると、項目を左、右、または下に配置できます。TextOrientation は、タブのテキストが、タブの方向に対してどのように表示されるかを決定します。TabPadding を使用すると、タブの内容と境界線との間のスペースの量を調整できます。

また、スクロール関連項目がいつ、どのように表示されるかを決定するプロパティもあります。これらのうち最もよく使用されるプロパティは ScrollButtons と ScrollButtonTypes です。

使用例

Visual Basic

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

C#

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;
}