com.vaadin.ui
Interface ComponentContainer

All Superinterfaces:

ClientConnector, Component, com.vaadin.shared.Connector, HasComponents, java.lang.Iterable<Component>, RpcTarget, java.io.Serializable, Sizeable

All Known Subinterfaces:

Layout

All Known Implementing Classes:

AbsoluteLayout, AbstractComponentContainer, AbstractLayout, AbstractOrderedLayout, AbstractSplitPanel, Accordion, CssLayout, CustomComponent, CustomLayout, DragAndDropWrapper, FormLayout, GridLayout, HorizontalLayout, HorizontalSplitPanel, LoginForm, Navigator.EmptyView, Panel, PopupView, TabSheet, UI, UI.LegacyWindow, VerticalLayout, VerticalSplitPanel, Window

public interface ComponentContainer
extends HasComponents

Extension to the Component interface which adds to it the capacity to contain other components. All UI elements that can have child elements implement this interface.

Since:

3.0

Author:

Vaadin Ltd.

Nested Class Summary

static class	ComponentContainer.ComponentAttachEvent Component attach event sent when a component is attached to container.
static interface	ComponentContainer.ComponentAttachListener Component attach listener interface.
static class	ComponentContainer.ComponentDetachEvent Component detach event sent when a component is detached from container.
static interface	ComponentContainer.ComponentDetachListener Component detach listener interface.

Nested classes/interfaces inherited from interface com.vaadin.ui.Component

Component.ErrorEvent, Component.ErrorListener, Component.Event, Component.Focusable, Component.Listener

Nested classes/interfaces inherited from interface com.vaadin.server.Sizeable

Sizeable.Unit

Field Summary

Fields inherited from interface com.vaadin.server.Sizeable

SIZE_UNDEFINED, UNITS_CM, UNITS_EM, UNITS_EX, UNITS_INCH, UNITS_MM, UNITS_PERCENTAGE, UNITS_PICAS, UNITS_PIXELS, UNITS_POINTS

Method Summary

void	addComponent(Component c) Adds the component into this container.
void	addComponentAttachListener(ComponentContainer.ComponentAttachListener listener) Listens the component attach events.
void	addComponentDetachListener(ComponentContainer.ComponentDetachListener listener) Listens the component detach events.
void	addListener(ComponentContainer.ComponentAttachListener listener) Deprecated. Since 7.0, replaced by addComponentAttachListener(ComponentAttachListener)
void	addListener(ComponentContainer.ComponentDetachListener listener) Deprecated. Since 7.0, replaced by addComponentDetachListener(ComponentDetachListener)
int	getComponentCount() Gets the number of children this ComponentContainer has.
java.util.Iterator<Component>	getComponentIterator() Deprecated. As of 7.0, use HasComponents.iterator() instead.
void	moveComponentsFrom(ComponentContainer source) Moves all components from an another container into this container.
void	removeAllComponents() Removes all components from this container.
void	removeComponent(Component c) Removes the component from this container.
void	removeComponentAttachListener(ComponentContainer.ComponentAttachListener listener) Stops the listening component attach events.
void	removeComponentDetachListener(ComponentContainer.ComponentDetachListener listener) Stops the listening component detach events.
void	removeListener(ComponentContainer.ComponentAttachListener listener) Deprecated. Since 7.0, replaced by removeComponentAttachListener(ComponentAttachListener)
void	removeListener(ComponentContainer.ComponentDetachListener listener) Deprecated. Since 7.0, replaced by removeComponentDetachListener(ComponentDetachListener)
void	replaceComponent(Component oldComponent, Component newComponent) Replaces the component in the container with another one without changing position.

Methods inherited from interface com.vaadin.ui.HasComponents

isComponentVisible, iterator

Methods inherited from interface com.vaadin.ui.Component

addListener, addStyleName, attach, getCaption, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getStyleName, getUI, isEnabled, isReadOnly, isVisible, removeListener, removeStyleName, setCaption, setEnabled, setIcon, setId, setPrimaryStyleName, setReadOnly, setStyleName, setVisible

Methods inherited from interface com.vaadin.server.ClientConnector

beforeClientResponse, detach, encodeState, getExtensions, getStateType, handleConnectorRequest, isConnectorEnabled, markAsDirty, markAsDirtyRecursive, removeExtension, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setParent

Methods inherited from interface com.vaadin.shared.Connector

getConnectorId

Methods inherited from interface com.vaadin.server.RpcTarget

getRpcManager

Methods inherited from interface com.vaadin.server.Sizeable

getHeight, getHeightUnits, getWidth, getWidthUnits, setHeight, setHeight, setSizeFull, setSizeUndefined, setWidth, setWidth

Method Detail

addComponent

void addComponent(Component c)

Adds the component into this container.

Parameters:

c - the component to be added.

removeComponent

void removeComponent(Component c)

Removes the component from this container.

Parameters:

c - the component to be removed.

removeAllComponents

void removeAllComponents()

Removes all components from this container.

replaceComponent

void replaceComponent(Component oldComponent,
                      Component newComponent)

Replaces the component in the container with another one without changing position.

This method replaces component with another one is such way that the new component overtakes the position of the old component. If the old component is not in the container, the new component is added to the container. If the both component are already in the container, their positions are swapped. Component attach and detach events should be taken care as with add and remove.

Parameters:

oldComponent - the old component that will be replaced.

newComponent - the new component to be replaced.

getComponentIterator

@Deprecated
java.util.Iterator<Component> getComponentIterator()

Deprecated. As of 7.0, use HasComponents.iterator() instead.

Gets an iterator to the collection of contained components. Using this iterator it is possible to step through all components contained in this container.

Returns:

the component iterator.

getComponentCount

int getComponentCount()

Gets the number of children this ComponentContainer has. This must be symmetric with what getComponentIterator() returns.

Returns:

The number of child components this container has.

Since:

7.0.0

moveComponentsFrom

void moveComponentsFrom(ComponentContainer source)

Moves all components from an another container into this container. The components are removed from source.

Parameters:

source - the container which contains the components that are to be moved to this container.

addComponentAttachListener

void addComponentAttachListener(ComponentContainer.ComponentAttachListener listener)

Listens the component attach events.

Parameters:

listener - the listener to add.

addListener

@Deprecated
void addListener(ComponentContainer.ComponentAttachListener listener)

Deprecated. Since 7.0, replaced by addComponentAttachListener(ComponentAttachListener)

removeComponentAttachListener

void removeComponentAttachListener(ComponentContainer.ComponentAttachListener listener)

Stops the listening component attach events.

Parameters:

listener - the listener to removed.

removeListener

@Deprecated
void removeListener(ComponentContainer.ComponentAttachListener listener)

Deprecated. Since 7.0, replaced by removeComponentAttachListener(ComponentAttachListener)

addComponentDetachListener

void addComponentDetachListener(ComponentContainer.ComponentDetachListener listener)

Listens the component detach events.

addListener

@Deprecated
void addListener(ComponentContainer.ComponentDetachListener listener)

Deprecated. Since 7.0, replaced by addComponentDetachListener(ComponentDetachListener)

removeComponentDetachListener

void removeComponentDetachListener(ComponentContainer.ComponentDetachListener listener)

Stops the listening component detach events.

removeListener

@Deprecated
void removeListener(ComponentContainer.ComponentDetachListener listener)

Deprecated. Since 7.0, replaced by removeComponentDetachListener(ComponentDetachListener)