Display the current set of records grouped by their values for the given field or fields. With no arguments, disables all grouping.
Grouping tranforms the current dataset into a Tree on the fly, then provides a familiar tree interface for exploring the grouped data.
Grouping works automatically with any dataset, providing simple default grouping based on each field's declared type. However, you can use the {@link com.smartgwt.client.widgets.grid.ListGridField#getGroupValue} API to control how records are grouped, and the{@link com.smartgwt.client.widgets.grid.ListGridField#getGroupTitle} API to control how groups are titled.
Grouping can be performed programmatically via this API, or you can set {@link com.smartgwt.client.widgets.grid.ListGrid#getCanGroupBy canGroupBy} to enable menus that allow the user toperforming grouping. To group a grid automatically, instantiate the grid with a {@link com.smartgwt.client.widgets.grid.ListGrid#getGroupByField groupByField} setting.
While grouped, theautomatically created Tree is available as {@link com.smartgwt.client.widgets.grid.ListGrid#getGroupTree groupTree} and the original dataset is availabe as {@link com.smartgwt.client.widgets.grid.ListGrid#getOriginalData originalData}.