com.smartgwt.client.widgets.grid.events

## Interface HasDataChangedHandlers

- All Superinterfaces:
    com.google.gwt.event.shared.HasHandlers
  All Known Implementing Classes:
    CalendarView, CubeGrid, DateGrid, EditTree, ListGrid, ListPalette, Menu, MenuPalette, PickListMenu, RecordEditor, SelectionTreeMenu, TableView, TreeGrid, TreePalette

      public interface HasDataChangedHandlers
      extends com.google.gwt.event.shared.HasHandlers

- - ### Method Summary

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method and Description
    --- | ---
    `com.google.gwt.event.shared.HandlerRegistration` | `addDataChangedHandler(DataChangedHandler handler)` Method invoked when changes to the listGrid's data occur.

    - ### Methods inherited from interface com.google.gwt.event.shared.HasHandlers

      `fireEvent`

- - ### Method Detail

    - #### addDataChangedHandler

          com.google.gwt.event.shared.HandlerRegistration addDataChangedHandler(DataChangedHandler handler)

      Method invoked when changes to the listGrid's data occur. This method will perform the necessary actions to ensure the changes to the data are reflected in the user interface, and then invoked the `dataChangedComplete()` notification method.

      May be invoked by any of the following:

      - a call to `addData()`, `updateData()`, or `removeData()`
      - `DataSource` updates from the server for `ResultSet` data (triggered by record editing, etc.)
      - fetches arriving back from the server for `ResultSet` data
      - changes to array data if made through APIs such as Array.set(), Array.add(), etc.
      - cache invalidation
      - filtering
      Calling `setData()` will not call this method directly, but it may fire if one of the above listed events is triggered (e.g. a server fetch for `ResultSet` data).

      Note that the `operationType` parameter is optional and will be passed and contain the operation (e.g. "update") if this notification was triggered by a fetch, an `addData()`, `updateData()`, or `removeData()`, or a `DataSource` update for `ResultSet` data (the first three reasons listed above) but otherwise will be null.

      Parameters:
        `handler` - the dataChanged handler
      Returns:
        `HandlerRegistration` used to remove this handler