com.vaadin.terminal.gwt.client
Interface ComponentContainerConnector

All Superinterfaces:

Connector, Serializable, ServerConnector

All Known Subinterfaces:

MayScrollChildren

All Known Implementing Classes:

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

public interface ComponentContainerConnector
extends ServerConnector

An interface used by client-side connectors whose widget is a component container (implements HasWidgets).

Method Summary

com.google.gwt.event.shared.HandlerRegistration	addConnectorHierarchyChangeHandler(ConnectorHierarchyChangeEvent.ConnectorHierarchyChangeHandler handler) Adds a handler that is called whenever the child hierarchy of this connector has been updated by the server.
List<ComponentConnector>	getChildComponents() Returns the children for this connector.
void	setChildComponents(List<ComponentConnector> children) Sets the children for this connector.
void	updateCaption(ComponentConnector connector) Update child components caption, description and error message.

Methods inherited from interface com.vaadin.terminal.gwt.client.ServerConnector

addStateChangeHandler, doInit, fireEvent, getChildren, getConnection, getParent, getRpcImplementations, isEnabled, onUnregister, setChildren, setParent, updateEnabledState

Methods inherited from interface com.vaadin.terminal.gwt.client.Connector

getConnectorId, getState

Method Detail

updateCaption

void updateCaption(ComponentConnector connector)

Update child components caption, description and error message.

Each component is responsible for maintaining its caption, description and error message. In most cases components doesn't want to do that and those elements reside outside of the component. Because of this layouts must provide service for it's childen to show those elements for them.

Parameters:

connector - Child component for which service is requested.

getChildComponents

List<ComponentConnector> getChildComponents()

Returns the children for this connector.

The children for this connector are defined as all ComponentConnectors whose parent is this ComponentContainerConnector.

Returns:

A collection of children for this connector. An empty collection if there are no children. Never returns null.

setChildComponents

void setChildComponents(List<ComponentConnector> children)

Sets the children for this connector. This method should only be called by the framework to ensure that the connector hierarchy on the client side and the server side are in sync.

Note that calling this method does not call ConnectorHierarchyChangeEvent.ConnectorHierarchyChangeHandler.onConnectorHierarchyChange(ConnectorHierarchyChangeEvent) . The event method is called only when the hierarchy has been updated for all connectors.

Parameters:

children - The new child connectors

addConnectorHierarchyChangeHandler

com.google.gwt.event.shared.HandlerRegistration addConnectorHierarchyChangeHandler(ConnectorHierarchyChangeEvent.ConnectorHierarchyChangeHandler handler)

Adds a handler that is called whenever the child hierarchy of this connector has been updated by the server.

Parameters:

handler - The handler that should be added.

Returns:

A handler registration reference that can be used to unregister the handler