Package com.smartgwt.client.widgets.grid.events

Interface GroupByCompleteHandler

All Superinterfaces:

EventHandler

public interface GroupByCompleteHandler
extends EventHandler

Method Summary

Modifier and Type	Method	Description
void	onGroupByComplete(GroupByCompleteEvent event)	Callback fired when the listGrid is grouped or ungrouped.

Method Details

onGroupByComplete

void onGroupByComplete(GroupByCompleteEvent event)

Callback fired when the listGrid is grouped or ungrouped.

Unlike ListGrid.groupBy(), this notification will fire when grouping is complete, and the data object has been updated. On successful grouping the fields argument will list the new grouping and the groupTree will have been updated to reflect the grouped data.

Note that the fields argument may be an empty array if the data is not grouped. This implies that a user or developer explicitly ungrouped the grid, or that a groupBy attempt failed due to the data length exceeding groupByMaxRecords.

By design, this method is not called when the data is regrouped, either programmatically, or in response to new data arriving from the server. You can use the callback ListGrid.groupTreeChanged() to be notified in that situation.

If you monitor only this method and call groupBy() before data is fetched, the notification that you'll receive will be for grouping the initial (perhaps empty) data set only. To have this method actually trigger when grouping of the fetched data is done, you should avoid calling groupBy() before the initial fetch, and instead do it in the the fetch callback.

Parameters:

event - the event