Spread Windows Forms 17
Spread Windows Forms 17.0 Product Documentation / Developer's Guide / Customizing Row or Column Interaction / Managing Grouping of Rows of User Data / Allowing the User to Group Rows
In This Topic
    Allowing the User to Group Rows
    In This Topic

    By default, the spreadsheet does not allow the user to group the rows of a spreadsheet. You can turn on this feature and allow grouping of rows for an entire sheet. Besides allowing grouping, you also need to allow columns to move, since the user performs grouping by clicking and dragging a column header into the group bar, which is similar to the act of moving a column. Also, the group bar must be visible and the column headers (at least one row) should be visible.

    The following image displays the component with grouping allowed.

    Spread component with grouping enabled

    Use the AllowGroup property of the sheet to turn on grouping. Use the Visible property of the GroupBarInfo class to display the group bar (the area at the top of the sheet into which the user can drag column headers. Remember to set the AllowColumnMove property of the Spread to True to allow the user to click and drag column headers. Unless you are using the default value, set the ColumnHeaderVisible property of the sheet to True to ensure that the column headers are displayed.

    You can turn on or off the row headers; these have no effect on the display of grouping.

    The AllowDragDrop property is not supported with grouping.

    You can set the maximum number of levels of grouping that the end user can set. This limits the number of column headers that can be dragged consecutively to the group bar.

    To understand how grouping works for the end user, refer to Using Grouping.

    Using Code

    1. Set the AllowColumnMove property to True.
    2. Set the Visible property to True.
    3. Set the AllowGroup property to True to allow the user to group the data.

    Example

    This example allows grouping.

    C#
    Copy Code
    fpSpread1.AllowColumnMove = true;
    fpSpread1.ActiveSheet.GroupBarInfo.Visible = true;
    fpSpread1.ActiveSheet.AllowGroup = true;
    
    VB
    Copy Code
    FpSpread1.AllowColumnMove = True
    FpSpread1.ActiveSheet.GroupBarInfo.Visible = True
    FpSpread1.ActiveSheet.AllowGroup = True
    
    See Also