'宣言 Public Class MdiTabGroupSettings Inherits Infragistics.Shared.SubObjectBase
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 です。
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; }