Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

GroupSettings Class

Maintains defaultable property settings for a group of DockablePaneBase instances.
Syntax
'Declaration
 
Public Class GroupSettings 
   Inherits Infragistics.Shared.SubObjectBase
public class GroupSettings : Infragistics.Shared.SubObjectBase
Remarks

The GroupSettings object is used to affect the appearance and behavior of DockableGroupPane objects. The values of each property are initialized with default values. These default values are resolved by a GroupSettingsResolved instance that may be access from the group's DockableGroupPane.GroupSettingsResolved property.

Example
The following examples initializes the settings of the GroupSettings object. This object is exposed as the DefaultGroupSettings property on the UltraDockManager and as the GroupSettings property on a DockableGroupPane.

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinDock

 Private Sub InitializeManagerGroupSettings()

    ' If the default group settings have been initialize, reset them
    If (Me.ultraDockManager1.HasDefaultGroupSettings) Then
        Me.ultraDockManager1.DefaultGroupSettings.Reset()
    End If

    ' The 'DefaultGroupSettings' is the default value used when resolving
    ' the 'GroupSettings' properties for DockableGroupPane instances. by
    ' initializing them here, we are setting the ultimate default values 
    ' for these properties but they can still be overriden on the group
    ' panes
    Me.InitializeGroupSettings(Me.ultraDockManager1.DefaultGroupSettings)

End Sub

Private Sub InitializeGroupSettings(ByVal settings As GroupSettings)

    ' Display the pane captions on the left side of the pane
    settings.CaptionLocation = Infragistics.Win.UltraWinDock.Location.Left

    ' Use a single pixel border on the sliding group buttons
    ' when the mouse moves over them
    settings.SlidingGroupButtonStyle = UIElementButtonStyle.ButtonSoft

    ' The buttons should be displayed horizontally - this only 
    ' affects the sliding group buttons in a group pane whose ChildPaneStyle
    ' is SlidingGroup
    settings.SlidingGroupOrientation = DefaultableOrientation.Horizontal

    ' Initialize the backcolor for the area behind the tabs in a tabgroup
    settings.TabAreaAppearance.BackColor = Color.AntiqueWhite

    ' Since the caption will be positioned to the left by default,
    ' we'll position the tabs to the right.
    settings.TabLocation = Infragistics.Win.UltraWinDock.Location.Right

    ' Display the image and text for the active tab but only the
    ' image for the other tabs
    settings.TabSizing = Infragistics.Win.UltraWinTabs.TabSizing.Compressed

    ' Display visual studio style tabs
    settings.TabStyle = Infragistics.Win.UltraWinTabs.TabStyle.VisualStudio

End Sub
using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinDock;
using System.Diagnostics;

private void InitializeManagerGroupSettings()
{

	// If the default group settings have been initialize, reset them
	if (this.ultraDockManager1.HasDefaultGroupSettings)
		this.ultraDockManager1.DefaultGroupSettings.Reset();

	// The 'DefaultGroupSettings' is the default value used when resolving
	// the 'GroupSettings' properties for DockableGroupPane instances. by
	// initializing them here, we are setting the ultimate default values 
	// for these properties but they can still be overriden on the group
	// panes
	this.InitializeGroupSettings(this.ultraDockManager1.DefaultGroupSettings);

}

private void InitializeGroupSettings( GroupSettings groupSettings )
{

	// Display the pane captions on the left side of the pane
	groupSettings.CaptionLocation = Infragistics.Win.UltraWinDock.Location.Left;

	// Use a single pixel border on the sliding group buttons
	// when the mouse moves over them
	groupSettings.SlidingGroupButtonStyle = UIElementButtonStyle.ButtonSoft;

	// The buttons should be displayed horizontally - this only 
	// affects the sliding group buttons in a group pane whose ChildPaneStyle
	// is SlidingGroup
	groupSettings.SlidingGroupOrientation = DefaultableOrientation.Horizontal;

	// Initialize the backcolor for the area behind the tabs in a tabgroup
	groupSettings.TabAreaAppearance.BackColor = Color.AntiqueWhite;

	// Since the caption will be positioned to the left by default,
	// we'll position the tabs to the right.
	groupSettings.TabLocation = Infragistics.Win.UltraWinDock.Location.Right;

	// Display the image and text for the active tab but only the
	// image for the other tabs
	groupSettings.TabSizing = Infragistics.Win.UltraWinTabs.TabSizing.Compressed;

	// Display visual studio style tabs
	groupSettings.TabStyle = Infragistics.Win.UltraWinTabs.TabStyle.VisualStudio;

}
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

See Also