com.vaadin.client

Interface ConnectorHierarchyChangeEvent.ConnectorHierarchyChangeHandler

All Superinterfaces:

com.google.gwt.event.shared.EventHandler, Serializable

All Known Implementing Classes:

AbsoluteLayoutConnector, AbstractComponentContainerConnector, AbstractHasComponentsConnector, AbstractLayoutConnector, AbstractOrderedLayoutConnector, AbstractSingleComponentContainerConnector, AbstractSplitPanelConnector, AccordionConnector, CssLayoutConnector, CustomComponentConnector, CustomFieldConnector, CustomLayoutConnector, DragAndDropWrapperConnector, FormConnector, FormLayoutConnector, GridConnector, GridLayoutConnector, HorizontalLayoutConnector, HorizontalSplitPanelConnector, LoginFormConnector, PanelConnector, PopupViewConnector, TableConnector, TabsheetBaseConnector, TabsheetConnector, TreeTableConnector, UIConnector, VerticalLayoutConnector, VerticalSplitPanelConnector, WindowConnector

Enclosing class:

ConnectorHierarchyChangeEvent

public static interface ConnectorHierarchyChangeEvent.ConnectorHierarchyChangeHandler
extends Serializable, com.google.gwt.event.shared.EventHandler

Handles connector hierarchy events. You should typically not directly implement this interface, but instead make your connector class extend AbstractHasComponentsConnector or an appropriate subclass.

Method Summary

Modifier and Type	Method and Description
void	onConnectorHierarchyChange(ConnectorHierarchyChangeEvent connectorHierarchyChangeEvent) Called by the framework when the list of child components of the connector implementing this interface has changed.

Method Detail

onConnectorHierarchyChange

void onConnectorHierarchyChange(ConnectorHierarchyChangeEvent connectorHierarchyChangeEvent)

Called by the framework when the list of child components of the connector implementing this interface has changed. The implementation is responsible for attaching the widgets of any new children and detaching the widgets of any removed children. Implementations should typically also make sure that the child widgets are attached according to the ordering of the child components.

This method is called after the shared state and hierarchy data (i.e. AbstractHasComponentsConnector.setChildComponents(List)) been updated for all affected connectors, but before updating captions, firing state change events, invoking updateFromUIDL for legacy connectors, invoking RPC and starting the layout phase.

Please note that hierarchy change events are fired in a non-deterministic order when a message from the server causes multiple parts of the hierarchy to change. This means that the old parent connector might not yet have detached a child widget and that the widget of a removed child might already have been attached by its new parent.

Parameters:

connectorHierarchyChangeEvent - the event with information about the hierarchy change