bibliothek.gui.dock.station
Class DisplayerCollection

java.lang.Object
  bibliothek.gui.dock.station.DisplayerCollection

All Implemented Interfaces:

java.lang.Iterable<DockableDisplayer>

public class DisplayerCollection
extends java.lang.Object
implements java.lang.Iterable<DockableDisplayer>

A set of DockableDisplayers. Clients may fetch a new displayer at any time. They should release a displayer which is no longer used. The collection ensures that various properties of the displayers are set in the proper order.

Author:

Benjamin Sigg

Constructor Summary

DisplayerCollection(DockStation station, DefaultDisplayerFactoryValue factory)
Creates a new collection

DisplayerCollection(DockStation station, DisplayerFactory factory)
Creates a new collection

Method Summary

void	addDockableDisplayerListener(DockableDisplayerListener listener) Adds listener to all DockableDisplayers that are in this collection.
DockableDisplayer	fetch(Dockable dockable, DockTitle title) Creates a new DockableDisplayer using the factory of this collection.
java.util.Iterator<DockableDisplayer>	iterator()
void	release(DockableDisplayer displayer) Releases a displayer that was created by this collection.
void	removeDockableDisplayerListener(DockableDisplayerListener listener) Removes listener from all DockableDisplayers that are in this collection.
void	setController(DockController controller) Sets the current DockController, that controller will be made known to all DockableDisplayer created by this collection.
void	setFactory(DisplayerFactory factory) Sets the factory that will create new DockableDisplayer when needed.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DisplayerCollection

public DisplayerCollection(DockStation station,
                           DisplayerFactory factory)

Creates a new collection

Parameters:

station - the station for which DockableDisplayer will be created

factory - the factory that is initially used to create displayers

DisplayerCollection

public DisplayerCollection(DockStation station,
                           DefaultDisplayerFactoryValue factory)

Creates a new collection

Parameters:

station - the station for which DockableDisplayers will be created

factory - the factory that is used create displayers

Method Detail

addDockableDisplayerListener

public void addDockableDisplayerListener(DockableDisplayerListener listener)

Adds listener to all DockableDisplayers that are in this collection.

Parameters:

listener - a new listener, not null

removeDockableDisplayerListener

public void removeDockableDisplayerListener(DockableDisplayerListener listener)

Removes listener from all DockableDisplayers that are in this collection.

Parameters:

listener - the listener to remove

iterator

public java.util.Iterator<DockableDisplayer> iterator()

Specified by:

iterator in interface java.lang.Iterable<DockableDisplayer>

fetch

public DockableDisplayer fetch(Dockable dockable,
                               DockTitle title)

Creates a new DockableDisplayer using the factory of this collection. This method also sets the title, station and the controller property of the displayer.
If the displayer is no longer needed, then it should be released

Parameters:

dockable - the Dockable which will be shown on the displayer.

title - the title which will be shown on the displayer, might be null

Returns:

the new displayer

release

public void release(DockableDisplayer displayer)

Releases a displayer that was created by this collection.

Parameters:

displayer - the displayer to release

setFactory

public void setFactory(DisplayerFactory factory)

Sets the factory that will create new DockableDisplayer when needed.

Parameters:

factory - the new factory, not null

setController

public void setController(DockController controller)

Sets the current DockController, that controller will be made known to all DockableDisplayer created by this collection.

Parameters:

controller - the new controller, can be null