Settings Property (MdiTabGroup)

Returns an MdiTabGroupSettings instance used to control the appearance and behavior for this MdiTabGroup

Syntax

Visual Basic

'Declaration
 
Public ReadOnly Property Settings As MdiTabGroupSettings

C#

public MdiTabGroupSettings Settings {get;}

Remarks

The Settings property returns an instance of an MdiTabGroupSettings object. This object has properties that affect the appearance and behavior of the group including the TabStyle, TabSizing, etc. The properties of this object are initialized with default values that need to be resolved to determine the values that will actually be used. The resolution for the Settings begins with this property. Any settings not explicitly set on this object are then checked on the TabGroupSettings of the owning Manager.

Note: This property will only affect the Tabs of this MdiTabGroup. If the MdiTabGroup does not contain any tabs, this property will have no effect on any tabs within the TabGroups of this MdiTabGroup.

Example

The following example demonstrates how to set the various MdiTabGroupSetting properties that relate to StateButton style tabs.

Visual Basic

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

Private Sub InitializeStateButtonTabGroup(ByVal tabGroup As MdiTabGroup)
    ' display the tabs as state buttons
    tabGroup.Settings.TabStyle = TabStyle.StateButtons

    ' display a separator bar between the state buttons
    tabGroup.Settings.ShowButtonSeparators = DefaultableBoolean.True

    ' leave 9 pixels of space between the state button tabs
    tabGroup.Settings.InterTabSpacing = New DefaultableInteger(9)

    ' use office xp style buttons for the close and scroll buttons
    tabGroup.Settings.ButtonStyle = UIElementButtonStyle.OfficeXPToolbarButton

    ' use the xp style chevron arrow for the scroll buttons
    tabGroup.Settings.ScrollArrowStyle = ScrollArrowStyle.WindowsXP

    ' only show the scroll buttons when needed
    tabGroup.Settings.ScrollButtons = DefaultableTabScrollButtons.Automatic

    ' show the next/previous and next page/ previous page buttons
    ' and scroll track/thumb when scroll buttons are displayed
    tabGroup.Settings.ScrollButtonTypes = ScrollButtonTypes.NextPagePreviousPage Or _
        ScrollButtonTypes.NextPrevious Or ScrollButtonTypes.Thumb

    ' when the scroll track is displayed, it should be no less than 40 pixels
    tabGroup.Settings.ScrollTrackExtent = 40
End Sub

C#

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

private void InitializeStateButtonTabGroup( MdiTabGroup tabGroup )
{
	// display the tabs as state buttons
	tabGroup.Settings.TabStyle = TabStyle.StateButtons;

	// display a separator bar between the state buttons
	tabGroup.Settings.ShowButtonSeparators = DefaultableBoolean.True;

	// leave 9 pixels of space between the state button tabs
	tabGroup.Settings.InterTabSpacing = new DefaultableInteger(9);

	// use office xp style buttons for the close and scroll buttons
	tabGroup.Settings.ButtonStyle = UIElementButtonStyle.OfficeXPToolbarButton;

	// use the xp style chevron arrow for the scroll buttons
	tabGroup.Settings.ScrollArrowStyle = ScrollArrowStyle.WindowsXP;

	// only show the scroll buttons when needed
	tabGroup.Settings.ScrollButtons = DefaultableTabScrollButtons.Automatic;

	// show the next/previous and next page/ previous page buttons
	// and scroll track/thumb when scroll buttons are displayed
	tabGroup.Settings.ScrollButtonTypes = ScrollButtonTypes.NextPagePreviousPage | 
		ScrollButtonTypes.NextPrevious |
		ScrollButtonTypes.Thumb;

	// when the scroll track is displayed, it should be no less than 40 pixels
	tabGroup.Settings.ScrollTrackExtent = 40;
}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2