Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

AllowGroupSwapping Property

Returns or sets a value that determines whether the user is allowed to swap groups.
Syntax
'Declaration
 
Public Property AllowGroupSwapping As AllowGroupSwapping
public AllowGroupSwapping AllowGroupSwapping {get; set;}
Remarks

The AllowGroupSwapping property determines whether groups can be swapped by the user in the band or the grid controlled by the specified override. Depending on the setting of AllowGroupSwapping, users can swap groups within the band, or not at all. In order for the user to be able to swap groups, group headers must be visible. If AllowGroupSwapping is set to allow group swapping, the group headers will display a dropdown interface that is used to select the group that will be swapped with the current one.

This property does not affect the ability of users to move groups using the group moving functionality of the group headers (controlled by the AllowGroupMoving property) or on the ability of the user to swap columns within the grid (controlled by the AllowColSwapping property).

When UltraGridBand.RowLayoutStyle is set to GroupLayout, swapping is only allowed between groups that have the same calculated SpanX and SpanY. Also, a group may never be swapped with any of it's ancestors or it's descendants.

Example
Following code sets the AllowGroupSwapping on the layout's override and a band's override.

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

  Private Sub Button5_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button5.Click

      ' Set AllowGroupSwapping to true to enable group swapping feature. When enabled, 
      ' the UltraGrid displays small drop down arrows on the group headers which when
      ' clicked upon drop down a drop down from which the user can select a different
      ' group to swap with.
      Me.UltraGrid1.DisplayLayout.Override.AllowGroupSwapping = AllowGroupSwapping.WithinBand

      ' You can override above grid-wide settings on a particular band by setting the
      ' property in question to a non-default value in the Override object of that 
      ' band.
      Me.UltraGrid1.DisplayLayout.Bands(0).Override.AllowGroupSwapping = AllowGroupSwapping.WithinBand

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

private void button5_Click(object sender, System.EventArgs e)
{

	// Set AllowGroupSwapping to true to enable group swapping feature. When enabled, 
	// the UltraGrid displays small drop down arrows on the group headers which when
	// clicked upon drop down a drop down from which the user can select a different
	// group to swap with.
	this.ultraGrid1.DisplayLayout.Override.AllowGroupSwapping = AllowGroupSwapping.WithinBand;

	// You can override above grid-wide settings on a particular band by setting the
	// property in question to a non-default value in the Override object of that 
	// band.
	this.ultraGrid1.DisplayLayout.Bands[0].Override.AllowGroupSwapping = AllowGroupSwapping.WithinBand;

}
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