AllowGroupBy プロパティ (UltraGridColumn)

GroupBy 列にするために、この列を GroupByBox にドラッグできるかどうかを設定します。Default は True に解決されます。

シンタックス

Visual Basic

'宣言
 
Public Property AllowGroupBy As Infragistics.Win.DefaultableBoolean

C#

public Infragistics.Win.DefaultableBoolean AllowGroupBy {get; set;}

解説

AllowGroupBy プロパティは、ユーザーが列をグループ化することができるかどうかを決定します。False に設定すると、ユーザーはグループ化ボックスからこの列を追加または削除することはできません。このプロパティは、コードで列によって行をグループ化することを防止しません。

行のグループ化機能を有効にするには、Layout の UltraGridLayout.ViewStyleBand プロパティを OutlookGroupBy に設定します。こうするとグリッドの最上部にグループボックスが表示され、ユーザーはそこに行をグループ化する基準となる列をドラッグ＆ドロップできるようになります。列による行のグループ化をコードで実行するには、列を UltraGridBand.SortedColumns コレクションに追加し、Add メソッドの groupBy パラメーターを True に指定します。

列の SortIndicator プロパティを Disabled に設定してソートを無効にすることもできることにも注意してください。SortIndicator が Disabled に設定される時に列によるグループ化も無効になります。

使用例

Visual Basic

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

  Private Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click

      ' Disallow the user to group rows by columns. Properties set on DisplayLayout's
      ' Override effect the whole grid.
      Me.UltraGrid1.DisplayLayout.Override.AllowGroupBy = DefaultableBoolean.False

      ' 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.AllowGroupBy = DefaultableBoolean.True

      ' Forthermore, you can override settings on the band's and layout's Override 
      ' objects by setting that property on the column itself.
      Me.UltraGrid1.DisplayLayout.Bands(0).Columns("CustomerID").AllowGroupBy = DefaultableBoolean.False

  End Sub

C#

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

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

	// Disallow the user to group rows by columns. Properties set on DisplayLayout's
	// Override effect the whole grid.
	this.ultraGrid1.DisplayLayout.Override.AllowGroupBy = DefaultableBoolean.False;

	// 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.AllowGroupBy = DefaultableBoolean.True;

	// Forthermore, you can override settings on the band's and layout's Override 
	// objects by setting that property on the column itself.
	this.ultraGrid1.DisplayLayout.Bands[0].Columns["CustomerID"].AllowGroupBy = DefaultableBoolean.False;

}