IndentationGroupByRow プロパティ

バンドのグループ行がオフセットされるピクセル数を取得または設定します。デフォルト値は-１で、オフセットがグリッドによって決定されることを意味します。

シンタックス

Visual Basic

'宣言
 
Public Property IndentationGroupByRow As Integer

C#

public int IndentationGroupByRow {get; set;}

解説

IndentationGroupByRow プロパティを使用すると、バンドのグループ行のインデント量を指定できます。このプロパティのデフォルト値は-1で、グリッドのデフォルトのインデント量が使用されることを示します。

グループ行のインデントは、IndentationGroupByRow の値と行のゼロから始まる深さレベルとの相関によって決まります。つまり、バンド内の最上位のグループ行は常にバンドの左端に揃います。これは、最上位のグループ行の深さレベルがゼロであるためです。

注: このプロパティを 0 に設定すると、バンド内のすべての GroupBy 行の左端が同じ X 座標になります。この場合は各グループ行の展開インジケーターの位置が自動的に決定され、展開インジケーターの相対的な位置によって各グループの関係が視覚的に表されます。この場合、グループ行展開インジケーターのインデントは、グループ行の深さレベルと、そのグループ行が属するバンドの IndentationGroupByRowExpansionIndicator 値との相関によって決まります。

使用例

Visual Basic

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

C#

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;
}