PowerTools SPREAD for ASP.NET 8.0J > 開発者の手引き > データ操作 > グループ化 > グループ化の許可 |
グループ化機能を有効にすると、ユーザーに対し、シート全体での行のグループ化を許可できます。グループ化を許可する場合は、1行以上の列ヘッダが表示され、列の移動も許可する必要があります。行のグループ化では、ユーザーは列ヘッダをクリックおよびドラッグしてグループバーを作成するためです。これは、列の移動に似た操作です。
また、グループバーを明示的に表示する必要があります。グループバーは高さや背景色のほか、ユーザーが設定可能なグループレベルの最大数も設定できます。これにより、1つのグループバー内に連続してドラッグ可能な列ヘッダ数が制限されます。
ユーザー操作ではなく、コードによるグループ化を制御する方法については「コードによるグループ化」を参照してください。
ユーザーにグループ化を許可するには、SheetView クラスのAllowGroup プロパティをtrueに設定します。また、GroupBarVisible プロパティをtrueに設定しグループバーを表示します。その他、以下のプロパティを使用して、グループバーを設定します。
プロパティ | 説明 |
---|---|
GroupBarBackColor | グループバーの背景色 |
GroupBarHeight | グループバーの高さ |
GroupBarText | グループバーに表示される文字列 |
GroupMaximumLevel | グループ化できる最大のレベル数 |
グループ化を実行したときに、アイテムが最初にすべて展開されるように、またはすべて縮小されるよう設定するには、GroupingPolicy プロパティを使用します。
次のサンプルコードは、ユーザーに行のグループ化を許可し、グループバーを設定します。
FpSpread1.ActiveSheetView.AllowColumnMove = true; FpSpread1.ActiveSheetView.AllowGroup = true; FpSpread1.ActiveSheetView.GroupBarVisible = true; FpSpread1.ActiveSheetView.GroupBarText = "列名をドラッグしてください"; FpSpread1.ActiveSheetView.GroupBarBackColor = Color.AliceBlue; FpSpread1.ActiveSheetView.GroupBarHeight = 40; FpSpread1.ActiveSheetView.GroupMaximumLevel = 3; FpSpread1.ActiveSheetView.GroupingPolicy = FarPoint.Web.Spread.Model.GroupingPolicy.CollapseAll;
FpSpread1.ActiveSheetView.AllowColumnMove = True FpSpread1.ActiveSheetView.AllowGroup = True FpSpread1.ActiveSheetView.GroupBarVisible = True FpSpread1.ActiveSheetView.GroupBarText = "列名をドラッグしてください" FpSpread1.ActiveSheetView.GroupBarBackColor = Color.AliceBlue FpSpread1.ActiveSheetView.GroupBarHeight = 40 FpSpread1.ActiveSheetView.GroupMaximumLevel = 3 FpSpread1.ActiveSheetView.GroupingPolicy = FarPoint.Web.Spread.Model.GroupingPolicy.CollapseAll