Version

ColSpan Property

Returns or sets a value that determines the number of columns to skip when synchronizing columns across multiple bands.
Syntax
'Declaration
 
Public Property ColSpan As Short
public short ColSpan {get; set;}
Remarks

This property performs a function similar to the COLSPAN attribute used in HTML tables. ColSpan is commonly used with the multi-band vertical view style when a band is indented from its parent. You can use it to "unlock" column synchronization for the first column in the child band so that it does not become too narrow by aligning itself with the edge of a column that ends directly above it in the parent band.

ColSpan and column synchronization have no effect on bands that contain groups; only bands that do not have groups will participate in column synchronization.

Example
Following code shows how to make use of ColSpan property to control column widths when columns from different bands are syncronized which they are by default.

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

  Private Sub Button10_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button10.Click

      ' ColSpan effects the width of the column. More accurately it dictates
      ' how many columns in other bands this column is syncronized with. 

      ' ColSpan only has an effect if the ColSizing mode is Syncronized which it 
      ' is by default.			
      Me.ultraGrid1.DisplayLayout.Override.AllowColSizing = AllowColSizing.Synchronized

      ' Set the ColSpan to 2.
      Me.ultraGrid1.DisplayLayout.Bands(0).Columns(1).ColSpan = 2

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

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

	// ColSpan effects the width of the column. More accurately it dictates
	// how many columns in other bands this column is syncronized with. 
	
	// ColSpan only has an effect if the ColSizing mode is Syncronized which it 
	// is by default.			
	this.ultraGrid1.DisplayLayout.Override.AllowColSizing = AllowColSizing.Synchronized;
	
	// Set the ColSpan to 2.
	this.ultraGrid1.DisplayLayout.Bands[0].Columns[1].ColSpan = 2;

}
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