IndentationGroupByRow Property

Gets/sets the number of pixels that the band's groupby rows will be offset. The default value is -1, which means that the grid will determine the offset.

Syntax

Visual Basic

public int IndentationGroupByRow {get; set;}

C#

'Declaration
 
Public Property IndentationGroupByRow As Integer

 

Remarks

You can use the IndentationGroupByRow property to specify how much indenting should be applied to the GroupBy rows in a band. The default value for this property is -1, which indicates that the grid's default indenting should be used.

The indentation of the GroupBy rows is a function of the IndentationGroupByRow value and the row's zero-based depth-level. In other words, the top-level GroupBy rows in a band will always be flush against the left edge of the band because the top-level GroupBy rows have a depth-level of zero.

Note: If this property is set to 0 then the left edge of all the GroupBy rows in the band will be at the same X coordinate. In this situation the grid automatically determines the location of the expansion indicators in each GroupBy row such that the relationships between the groupings are visually represented via the relative location of said expansion indicators. The indentation of the GroupBy row expansion indicators is, in this case, a function of a GroupBy row's "depth level" and the IndentationGroupByRowExpansionIndicator value of that GroupBy row's respective band.

Example

This snippet demonstrates the IndentationGroupByRow and IndentationGroupByRowExpansionIndicator properties on the UltraGridBand class.

Private Sub Form1_Load(sender As Object, e As System.EventArgs)
   ' Make all of the GroupBy rows in the first band flush against the left edge of the grid.
   '
   Me.ultraGrid1.DisplayLayout.Bands(0).IndentationGroupByRow = 0
   
   ' Since the IndentationGroupByRow property is set to zero, there needs to be a way to
   ' depict the nested relationships between the GroupBy rows.  Setting this property will
   ' cause the expansion indicator offsets to accumulate as the nesting depth-level increases,
   ' which will produce the desired result.  Note, this "accumulation" of expansion indicator 
   ' offsets only occurs when the IndentationGroupByRow is set to 0. Normally the expansion
   ' indicator offset does not accumulate but remains a fixed value across all GroupBy rows.
   '
   Me.ultraGrid1.DisplayLayout.Bands(0).IndentationGroupByRowExpansionIndicator = 26
End Sub

'Declaration
 
Public Property IndentationGroupByRow As Integer

 

private void Form1_Load(object sender, System.EventArgs e)
{	
	// Make all of the GroupBy rows in the first band flush against the left edge of the grid.
	//
	this.ultraGrid1.DisplayLayout.Bands[0].IndentationGroupByRow = 0;

	// Since the IndentationGroupByRow property is set to zero, there needs to be a way to
	// depict the nested relationships between the GroupBy rows.  Setting this property will
	// cause the expansion indicator offsets to accumulate as the nesting depth-level increases,
	// which will produce the desired result.  Note, this "accumulation" of expansion indicator 
	// offsets only occurs when the IndentationGroupByRow is set to 0. Normally the expansion
	// indicator offset does not accumulate but remains a fixed value across all GroupBy rows.
	//
	this.ultraGrid1.DisplayLayout.Bands[0].IndentationGroupByRowExpansionIndicator = 26;
}

'Declaration
 
Public Property IndentationGroupByRow As Integer

 

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