Version

UltraGridBand Class

An object that represents a set of related columns of data.
Syntax
'Declaration
 
Public Class UltraGridBand 
   Inherits Infragistics.Shared.KeyedSubObjectBase
   Implements Infragistics.Shared.IKeyedSubObject, Infragistics.Shared.IKeyedSubObjectEx, Infragistics.Win.Layout.ILayoutGroup 
public class UltraGridBand : Infragistics.Shared.KeyedSubObjectBase, Infragistics.Shared.IKeyedSubObject, Infragistics.Shared.IKeyedSubObjectEx, Infragistics.Win.Layout.ILayoutGroup 
Remarks

An UltraGridBand object represents a set of related columns in an UltraGrid, UltraCombo or UltraDropDown control. In the case of flat data there is only 1 band, whereas a grid with hierarchical data will have multiple bands.

            Private Sub CheckBox1_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles CheckBox1.CheckedChanged
            
                Dim band As Infragistics.Win.UltraWinGrid.UltraGridBand
            
                band = Me.UltraGrid1.DisplayLayout.Bands(0)
            
                band.AddButtonCaption = "Customers"
                band.AddButtonToolTipText = "Adds a new Customer record."
                band.AutoPreviewEnabled = False
                band.AutoPreviewField = ""
                band.AutoPreviewIndentation = 15
                band.AutoPreviewMaxLines = 3
                band.ColHeadersVisible = True
                band.ColHeaderLines = 2
                band.HeaderVisible = True
                band.ScrollTipField = "Cust_ID"
                band.Override.BorderStyleRow = Infragistics.Win.UIElementBorderStyle.InsetSoft
            
                band.CardView = True
                band.CardSettings.CaptionField = "Name"
                band.CardSettings.AllowLabelSizing = True
                band.CardSettings.AllowSizing = True
                band.CardSettings.Style = Infragistics.Win.UltraWinGrid.CardStyle.MergedLabels
                band.CardSettings.ShowCaption = True
                band.CardSettings.AutoFit = True
            
            End Sub

Example
Following code shows how one can enable and customize the Row Auto Preview functionality.

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

  Private Sub Button25_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button25.Click

      Dim band As UltraGridBand = Me.UltraGrid1.DisplayLayout.Bands(0)

      ' Set the AutoPreviewEnabled to enable row previews.
      band.AutoPreviewEnabled = True

      ' Set the AutoPrevieField to the field contents of which will be  displayed
      ' in the row preview.
      band.AutoPreviewField = "Address"

      ' Indent the text in row previews by 5 pixels
      band.AutoPreviewIndentation = 5

      ' Allow the row previews to display up to 4 lines of text if the text is 
      ' multiline.
      band.AutoPreviewMaxLines = 4

      ' Change how the row preview will look by setting RowPreviewAppearance 
      ' off the override.
      band.Override.RowPreviewAppearance.BackColor = Color.DarkBlue
      band.Override.RowPreviewAppearance.ForeColor = Color.LightYellow

      ' You can set the row preview appearance on per row basis overriding the
      ' settings on the Override.RowPreviewAppearance.
      Me.UltraGrid1.Rows(0).PreviewAppearance.BackColor = Color.Red

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

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

	UltraGridBand band = this.ultraGrid1.DisplayLayout.Bands[0];
	 
	// Set the AutoPreviewEnabled to enable row previews.
	band.AutoPreviewEnabled = true;	
	 
	// Set the AutoPrevieField to the field contents of which will be  displayed
	// in the row preview.
	band.AutoPreviewField = "Address";
	 
	// Indent the text in row previes by 5 pixels
	band.AutoPreviewIndentation = 5;

	// Allow the row previews to display upto 4 lines of text if the text is 
	// multiline.
	band.AutoPreviewMaxLines = 4;
	 
	// Change how the row preview will look by setting RowPreviewAppearance 
	// off the override.
	band.Override.RowPreviewAppearance.BackColor = Color.DarkBlue;
	band.Override.RowPreviewAppearance.ForeColor = Color.LightYellow;

	// You can set the row preview appearance on per row basis overrideing the
	// settings on the Override.RowPreviewAppearance.
	this.ultraGrid1.Rows[0].PreviewAppearance.BackColor = Color.Red;

}
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