bibliothek.gui.dock
Class SplitDockStation

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JLayeredPane
                  bibliothek.gui.dock.station.OverpaintablePanel
                      bibliothek.gui.dock.security.SecureContainer
                          bibliothek.gui.dock.SplitDockStation

All Implemented Interfaces:

DockComponentRoot, DockElement, DockElementRepresentative, PlaceholderListItem<Dockable>, Dockable, DockStation, ImageObserver, MenuContainer, Serializable, Accessible

Direct Known Subclasses:

CSplitDockStation

public class SplitDockStation
extends SecureContainer
implements Dockable, DockStation

This station shows all its children at once. The children are separated by small gaps which can be moved by the user. It is possible to set one child to fullscreen, this child will be shown above all other children. The user can double click on the title of a child to change its fullscreen-mode.
The station tries to register a DockTitleFactory with the ID TITLE_ID.

Author:

Benjamin Sigg

See Also:

Serialized Form

Nested Class Summary

protected class	SplitDockStation.Access Access to this SplitDockStation.
static class	SplitDockStation.Orientation Orientation how two Dockables are aligned.

Nested classes/interfaces inherited from class javax.swing.JLayeredPane

JLayeredPane.AccessibleJLayeredPane

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

static String	DISPLAYER_ID This id is forwarded to Extensions which load additional DisplayerFactorys
static PropertyKey<SplitDividerStrategy>	DIVIDER_STRATEGY The algorithm that allows users to resize children of a SplitDockStation by grabbing a gap between two children and moving that gap around.
protected DockStationListenerManager	dockStationListeners The list of all registered DockStationListeners.
static PropertyKey<SplitLayoutManager>	LAYOUT_MANAGER Defines the behavior of a DockStation, how to react on a drop-event, how to react on resize and other things related to the layout.
static PropertyKey<KeyStroke>	MAXIMIZE_ACCELERATOR Describes which KeyEvent will maximize/normalize the currently selected Dockable.
static String	TITLE_ID The ID under which this station tries to register a DockTitleFactory

Fields inherited from class javax.swing.JLayeredPane

DEFAULT_LAYER, DRAG_LAYER, FRAME_CONTENT_LAYER, LAYER_PROPERTY, MODAL_LAYER, PALETTE_LAYER, POPUP_LAYER

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

SplitDockStation()
Constructs a new SplitDockStation.

SplitDockStation(boolean createFullScreenAction)
Creates a new SplitDockStation.

Method Summary

boolean	accept(Dockable child) Tells whether this station accepts child as a new child, or refuses child.
boolean	accept(DockStation station) Tells whether station is an accepted parent for this Dockable or not.
boolean	accept(DockStation base, Dockable neighbour) Tells whether base could be the parent of a combination between this Dockable and neighbor.
void	addDockable(Dockable dockable) Adds dockable to this station.
void	addDockableListener(DockableListener listener) Adds a listener to this Dockable.
void	addDockableStateListener(DockableStateListener listener) Adds listener to this Dockable.
void	addDockHierarchyListener(DockHierarchyListener listener) Adds a hierarchy-listener to this Dockable.
void	addDockStationListener(DockStationListener listener) Adds a listener to this station.
void	addMouseInputListener(MouseInputListener listener) Adds a MouseInputListener to the component of this Dockable.
void	addSplitDockStationListener(SplitDockListener listener) Adds a listener to this station.
Dockable	asDockable() Returns this if this is an instance of Dockable.
DockStation	asDockStation() Returns this if this is an instance of DockStation.
void	aside(AsideRequest request) Requests this DockStation to find a DockableProperty that is "aside" another property.
void	bind(DockTitle title) Called by clients which want to show a title of this Dockable.
protected void	callDockUiUpdateTheme() Calls the method DockUI.updateTheme(DockStation, DockFactory) with this as the first argument, and an appropriate factory as the second argument.
boolean	canDrag(Dockable dockable) Tells whether dockable can be removed from this station or not.
boolean	canReplace(Dockable old, Dockable next) Tells whether its possible to replace the child old with next where next is not a child of this station.
void	changed(Dockable dockable, DockTitle title, boolean active) Called by the DockController of this station to indicate that the active-state of title has been changed.
void	configureDisplayerHints(DockableDisplayerHints hints) Orders this Dockable to configure hints which will be used by the parent component of this element.
protected ListeningDockAction	createFullScreenAction() Creates an action which is added to all children of this station.
protected SplitPlaceholderConverter	createPlaceholderConverter() Creates the algorithm that is used by getPlaceholders() and setPlaceholders(PlaceholderMap).
protected DockComponentRootHandler	createRootHandler() Creates a new DockComponentRootHandler for monitoring all the Components of this station.
DockableSplitDockTree	createTree() Gets the contents of this station as a SplitDockTree.
void	createTree(SplitDockTreeFactory factory) Writes the contents of this station into factory.
protected void	discard(DockableDisplayer displayer) Removes displayer and creates a replacement.
void	drag(Dockable dockable) Removes a child from this station.
void	drop(Dockable dockable) Adds dockable to this station.
boolean	drop(Dockable dockable, DockableProperty property) Tries to add dockable to this station such that the location given by property is matched.
boolean	drop(Dockable dockable, SplitDockFullScreenProperty property) Drops dockable on this station, may exchange the full screen element to ensure that dockable is displayed.
boolean	drop(Dockable dockable, SplitDockPathProperty property) Tries to insert dockable at a location such that the path to that location is the same as described in property.
boolean	drop(Dockable dockable, SplitDockPlaceholderProperty property) Drops dockable at the placeholder that is referenced by property.
boolean	drop(Dockable dockable, SplitDockProperty property) Tries to add Dockable such that the boundaries given by property are full filled.
protected boolean	dropAside(SplitNode neighbor, PutInfo.Put put, Dockable dockable, Leaf leaf, double divider, DockHierarchyLock.Token token) Adds dockable at the side put of neighbor.
void	dropGrid(SplitDockGrid grid) Copies the layout of grid.
protected boolean	dropOver(Leaf leaf, Dockable dockable, CombinerSource source, CombinerTarget target) Combines the Dockable of leaf and dockable to a new child of this station.
protected boolean	dropOver(Leaf leaf, Dockable dockable, DockableProperty property, CombinerSource source, CombinerTarget target) Combines the Dockable of leaf and dockable to a new child of this station.
void	dropTree(SplitDockTree<Dockable> tree) Removes all children from this station and then adds the contents that are stored in tree.
void	dropTree(SplitDockTree<Dockable> tree, boolean checkValidity) Removes all children from this station and then adds the contents that are stored in tree.
protected void	fireFullScreenChanged(Dockable oldDockable, Dockable newDockable) Sends a message to all registered instances of SplitDockListener, that the Dockable in fullscreen-mode has changed.
protected void	fireTitleExchanged() Informs all DockableListeners that all bound titles and the null title are no longer considered good titles and should be replaced
protected void	fireTitleExchanged(DockTitle title) Informs all DockableListeners that title is no longer considered to be a good title and should be exchanged.
protected SplitDockStation.Access	getAccess() Allows subclasses access to the internal working of this SplitDockStation.
int	getBorderSideSnapSize() Gets the size of the border around the station.
StationCombinerValue	getCombiner() Gets a Combiner to combine Dockables on this station.
Component	getComponent() Gets the Component which represents this Dockable.
DockComponentConfiguration	getComponentConfiguration() Gets the currently applied configuration.
protected DockableDisplayerHints	getConfigurableDisplayerHints() Gets the argument that was last used for configureDisplayerHints(DockableDisplayerHints).
DockController	getController() Gets the controller which tells whether a restricted environment is in use.
SplitLayoutManager	getCurrentSplitLayoutManager() Gets the SplitLayoutManager that is currently used by this station.
DefaultDockActionSource	getDirectActionOffers(Dockable dockable) Gets a list of actions which should be available for the user and affect the child dockable.
DefaultDisplayerFactoryValue	getDisplayerFactory() Gets a DisplayerFactory to create new DockableDisplayer for this station.
DisplayerCollection	getDisplayers() Gets the set of displayers that are currently used by this station.
int	getDividerSize() Gets the size of the divider-gap.
SplitDividerStrategy	getDividerStrategy() Gets the SplitDividerStrategy that is used to handle the divider of this station.
Dockable	getDockable(int index) Gets the index'th child of this station.
int	getDockableCount() Gets the number of children.
SplitDockProperty	getDockableLocationProperty(Dockable dockable) Creates a DockableProperty for the location of dockable.
SplitDockPathProperty	getDockablePathProperty(Dockable dockable) Creates a DockableProperty for the location of dockable.
SplitDockPathProperty	getDockablePathProperty(Path placeholder) Creates a DockableProperty pointing to the leaf containing placeholder.
SplitDockPlaceholderProperty	getDockablePlaceholderProperty(Dockable dockable, Dockable target) Creates a SplitDockPlaceholderProperty for dockable, may insert an additional placeholder in the tree.
DockableProperty	getDockableProperty(Dockable child, Dockable target) Gets precise information about the location of a child of this station.
DockStation	getDockParent() Gets the current parent, which is the latest argument of Dockable.setDockParent(DockStation).
PutInfo	getDropInfo() Gets the location where the currently dragged Dockable would be dropped.
protected bibliothek.gui.dock.SplitDockStation.DropInfo	getDropInfo(SplitDockProperty property, Dockable dockable, SplitNode root) Searches for the best place for dockable such that its boundaries met property.
DockElement	getElement() Gets the element which is represented by this.
String	getFactoryID() Gets the unique name of the DockFactory which can read and write elements of this type.
Dockable	getFrontDockable() Gets the favorite child of this station.
Dockable	getFullScreen() Gets the Dockable which is in fullscreen-mode and covers all other children of this station.
DockActionSource	getGlobalActionOffers() Gets a list of all DockActions which might be triggered while this Dockable is visible.
DockActionSource	getIndirectActionOffers(Dockable dockable) Gets a list of actions which should be available for the user and affect dockable.
DockStationDropLayer[]	getLayers() Gets a description of all the areas of the screen where this DockStation can handle a drop event. Everytime the mouse is moved or released during a drag & drop operation, this method is called for all DockStations.
DockActionSource	getLocalActionOffers() Gets a list of DockActions which should be triggerable if this Dockable is visible.
protected Tuple<Integer,SplitNode>	getLowestNode(SplitDockPathProperty property) Searches the lowest node whose identifier is equal to an identifier from property.
Dimension	getMinimumLeafSize() Gets the minimum size a Leaf can have.
Dimension	getMinimumSize()
SplitNode	getNode(long id) Searches the node whose id equals id.
SplitNodeFactory	getNodeFactory() Gets the factory which is responsible for creating new SplitNodes.
DefaultStationPaintValue	getPaint() Gets a StationPaint to paint markings on this station.
PlaceholderMapping	getPlaceholderMapping() Allows access to the placeholders that are stored on this station.
PlaceholderMap	getPlaceholders() Gets a snapshot of all placeholders that are currently stored in this DockStation.
RootPlaceholderStrategy	getPlaceholderStrategy() Gets the strategy for creating and storing placeholders.
Point	getPopupLocation(Point click, boolean popupTrigger) Tells whether a popup menu should be opened when the user clicks at click with the mouse.
Dimension	getPreferredSize()
Root	getRoot() Gets the Root of the tree which stores all locations and sizes of the children of this station.
float	getSideSnapSize() Gets the relative size of the invisible border of all children.
protected SplitSpanStrategy	getSpanStrategy() Gets read access to the strategy which is responsible for handling the Spans of this station.
SplitLayoutManager	getSplitLayoutManager() Gets the layout manager which was explicitly set.
DockTheme	getTheme() Gets the current theme of this station.
Icon	getTitleIcon() Gets the current icon of this Dockable.
String	getTitleText() Gets the current title-text of this Dockable.
String	getTitleToolTip() Gets a tooltip that is associated with this Dockable and that should be shown on any DockTitle.
boolean	hasFullScreenAction() Tells whether createFullScreenAction() was called and returned a value other than null.
int	indexOfDockable(Dockable dockable) Gets the index of a child of this station.
boolean	isAllowSideSnap() Tells whether the station can grab Dockables which are dragged near the station.
boolean	isChildShowing(Dockable dockable) Tells whether the child dockable is visible or not.
boolean	isContinousDisplay() Tells whether the dockables are resized while the split is dragged, or not.
boolean	isDisabled() Tells the result of the current DisablingStrategy.
boolean	isDockableShowing() Tells whether this Dockable can be seen by the user.
boolean	isDockableVisible() Deprecated.
boolean	isExpandOnDoubleclick() Tells whether a child expands to fullscreen when double clicked or not.
boolean	isFullScreen() Tells whether a Dockable is currently shown in fullscreen-mode on this station.
boolean	isResizingEnabled() Tells whether the user can drag dividiers and resize dockables in this way.
boolean	isStationShowing() Tells whether this station is visible or not.
boolean	isStationVisible() Deprecated.
boolean	isUsedAsTitle() Tells whether this DockElementRepresentative is used as title. Some modules grant more rights to titles than to non-titles, i.e.
boolean	isVisible(Dockable dockable) Deprecated.
DockTitle[]	listBoundTitles() Gets a list of all DockTitles which are currently bound to this Dockable.
void	move(Dockable dockable, DockableProperty property) Tries to move the child dockable in such a way, that DockStation.getDockableProperty(Dockable, Dockable) would return a DockableProperty that equals property. There is no need to give a guarantee that the move successes, and clients should always be prepared for the possibility that this DockStation does nothing at all.
protected void	paintOverlay(Graphics g) Paints the overlay over all components.
StationDragOperation	prepareDrag(Dockable dockable) Informs this station that a drag and drop operation is in progress and that dockable might be removed from this station.
StationDropOperation	prepareDrop(StationDropItem item) Prepares this station to get the new child dockable or to move around the known child dockable.
void	removeAllDockables() Removes all children from this station. Note: clients may need to invoke DockController.freezeLayout() and DockController.meltLayout() to ensure noone else adds or removes Dockables.
void	removeDockable(Dockable dockable) Removes dockable from this station.
void	removeDockableListener(DockableListener listener) Removes a listener from this Dockable.
void	removeDockableStateListener(DockableStateListener listener) Removes listener from this element.
void	removeDockHierarchyListener(DockHierarchyListener listener) Removes a hierarchy-listener from this Dockable. Note: when using a DockHierarchyObserver, forward the call directly to DockHierarchyObserver.removeDockHierarchyListener(DockHierarchyListener)
void	removeDockStationListener(DockStationListener listener) Removes a listener from this station.
void	removeMouseInputListener(MouseInputListener listener) Removes a listener that was earlier added to this Dockable.
void	removePlaceholder(Path placeholder) Searches the entire tree for any occurence of placeholder and removes placeholder.
void	removePlaceholders(Set<Path> placeholders) Searches the entire tree for all occurences of all placeholders in placeholders.
void	removeSplitDockStationListener(SplitDockListener listener) Removes an earlier added listener.
void	replace(Dockable previous, Dockable next) Replaces the child old by next which is not yet a child of this station.
void	replace(DockStation old, Dockable next) Replaces the child old by next which is not yet a child of this station.
void	requestChildDisplayer(DisplayerRequest request) Provides a DockableDisplayer for a child of this station.
void	requestChildDockTitle(DockTitleRequest request) Provides a DockTitle for a child of this station.
void	requestDisplayer(DisplayerRequest request) Invoked to get DockableDisplayer for this Dockable.
void	requestDockTitle(DockTitleRequest request) Invoked to get a graphical representation of a title for this Dockable.
void	resetTitleIcon() Resets the icon of this SplitDockStation, the default icon is shown again.
protected Root	root() Gets the root of this station, creates a root if necessary.
void	setAllowSideSnap(boolean allowSideSnap) Sets whether Dockables which are dragged near the station are captured and added to this station.
void	setBorderSideSnapSize(int borderSideSnapSize) There is an invisible border around the station.
void	setComponentConfiguration(DockComponentConfiguration configuration) Sets a configuration which is to be applied to all Components (and maybe their children) of this DockComponentRoot.
void	setContinousDisplay(boolean continousDisplay) Sets whether the dockables should be resized while the split is dragged, or not.
void	setController(DockController controller) Sets the controller which tells whether a restricted environment is in use.
protected void	setDisabled(boolean disabled) Called by the current DisablingStrategy when this station changes its state.
void	setDividerSize(int dividerSize) Sets the size of the divider-gap between the children of this station.
void	setDividerStrategy(SplitDividerStrategy strategy) Sets the SplitDividerStrategy that should be used to handle the divider of this station.
void	setDockParent(DockStation station) Sets the parent property.
protected void	setDropInfo(PutInfo putInfo) Sets the current information telling where and how an item is to be dropped.
void	setExpandOnDoubleclick(boolean expandOnDoubleclick) Sets whether a double click on a child or its title can expand the child to fullscreen or not.
void	setFrontDockable(Dockable dockable) Sets the most important child.
void	setFullScreen(Dockable dockable) Sets one of the children of this station as the one child which covers all other children.
void	setFullScreenAction(ListeningDockAction fullScreenAction) Sets an action which allows to expand children.
void	setMinimumLeafSize(Dimension minimumLeafSize) Sets the minimum size a Leaf can have.
void	setNextFullScreen() Switches the child which is in fullscreen-mode.
void	setNodeFactory(SplitNodeFactory factory) Sets the factory which is responsible for creating new SplitNodes.
void	setPlaceholders(PlaceholderMap placeholders) Sets an earlier snapshot of the placeholders of this station.
void	setPlaceholderStrategy(PlaceholderStrategy strategy) Sets the strategy for selecting placeholders when removing Dockables from this station.
protected void	setPut(PutInfo putInfo) Forward call to SplitSpanStrategy.setPut(PutInfo).
void	setResizingEnabled(boolean resizingEnabled) Enables the user to resize the children of this station.
void	setSideSnapSize(float sideSnapSize) Every child has an invisible border whose size is determined by sideSnapSize.
void	setSplitLayoutManager(SplitLayoutManager manager) Sets a special SplitLayoutManager which this station has to use.
void	setTitleIcon(Icon titleIcon) Sets an icon that is shown in the titles of this Dockable.
void	setTitleText(String titleText) Sets the text of the title of this dockable.
void	setTitleToolTip(String text) Sets the tooltip that should be shown on any title that is bound to this dockable.
boolean	shouldFocus() Tells whether a click onto this component should transfer the focus either to this component or to the Dockable.
boolean	shouldTransfersFocus() Tells whether a click onto this component should transfer the focus to the Dockable or not.
String	toString()
void	unbind(DockTitle title) Clients should call this method if a DockTitle is no longer needed.
protected void	unsetDropInfo() Resets the information telling where and how an item is to be dropped.
protected void	unsetPut() Forward call to SplitSpanStrategy.unsetPut().
void	updateBounds() Updates all locations and sizes of the Components which are in the structure of this tree.
protected void	updateConfigurableDisplayerHints() Updates the current hints of this station.
void	updateTheme() Updates the DockTheme of this station.
protected void	updateVisibility() Calls Component.setVisible(boolean) on all current children and updates the visibility.
<N> N	visit(SplitTreeFactory<N> factory) Visits the internal structure of this station.

Methods inherited from class bibliothek.gui.dock.security.SecureContainer

createGlassPane, install, isUseGlassPane, setUseGlassPane, uninstall

Methods inherited from class bibliothek.gui.dock.station.OverpaintablePanel

doLayout, getBasePane, getContentPane, getMaximumSize, isSolid, setBasePane, setContentPane, setSolid

Methods inherited from class javax.swing.JLayeredPane

addImpl, getAccessibleContext, getComponentCountInLayer, getComponentsInLayer, getComponentToLayer, getIndexOf, getLayer, getLayer, getLayeredPaneAbove, getObjectForLayer, getPosition, highestLayer, insertIndexForLayer, isOptimizedDrawingEnabled, lowestLayer, moveToBack, moveToFront, paint, paramString, putLayer, remove, removeAll, setLayer, setLayer, setPosition

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

TITLE_ID

public static final String TITLE_ID

The ID under which this station tries to register a DockTitleFactory

See Also:

Constant Field Values

DISPLAYER_ID

public static final String DISPLAYER_ID

This id is forwarded to Extensions which load additional DisplayerFactorys

See Also:

Constant Field Values

MAXIMIZE_ACCELERATOR

public static final PropertyKey<KeyStroke> MAXIMIZE_ACCELERATOR

Describes which KeyEvent will maximize/normalize the currently selected Dockable.

LAYOUT_MANAGER

public static final PropertyKey<SplitLayoutManager> LAYOUT_MANAGER

Defines the behavior of a DockStation, how to react on a drop-event, how to react on resize and other things related to the layout.

DIVIDER_STRATEGY

public static final PropertyKey<SplitDividerStrategy> DIVIDER_STRATEGY

The algorithm that allows users to resize children of a SplitDockStation by grabbing a gap between two children and moving that gap around.

dockStationListeners

protected DockStationListenerManager dockStationListeners

The list of all registered DockStationListeners. This list can be used to send events to all listeners.

Constructor Detail

SplitDockStation

public SplitDockStation()

Constructs a new SplitDockStation.

SplitDockStation

public SplitDockStation(boolean createFullScreenAction)

Creates a new SplitDockStation.

Parameters:

createFullScreenAction - whether createFullScreenAction() should be called or not

Method Detail

createRootHandler

protected DockComponentRootHandler createRootHandler()

Creates a new DockComponentRootHandler for monitoring all the Components of this station.

Returns:

the new handler

root

protected final Root root()

Gets the root of this station, creates a root if necessary. This method cannot be overridden while getRoot() can. This method just returns the value of root, makes it a read only variable.

Returns:

the root

See Also:

getRoot()

toString

public String toString()

Overrides:

toString in class Component

getMinimumSize

public Dimension getMinimumSize()

Overrides:

getMinimumSize in class OverpaintablePanel

getPreferredSize

public Dimension getPreferredSize()

Overrides:

getPreferredSize in class OverpaintablePanel

getTheme

public DockTheme getTheme()

Description copied from interface: DockStation

Gets the current theme of this station. The theme can be null, but that means that the station is not fully initialized, and might not work correct.

Specified by:

getTheme in interface DockStation

Returns:

the theme of this station or null.

updateTheme

public void updateTheme()

Description copied from interface: DockStation

Updates the DockTheme of this station. The new theme has to be read from the controller of this station. If the controller is null, this method should return immediately.
You may use DockUI.updateTheme(DockStation, DockFactory) to implement this method.

Specified by:

updateTheme in interface DockStation

callDockUiUpdateTheme

protected void callDockUiUpdateTheme()
                              throws IOException

Calls the method DockUI.updateTheme(DockStation, DockFactory) with this as the first argument, and an appropriate factory as the second argument.

Throws:

IOException - if the DockUI throws an exception

createFullScreenAction

protected ListeningDockAction createFullScreenAction()

Creates an action which is added to all children of this station. The action allows the user to expand a child to fullscreen. The action is also added to subchildren, but the effect does only affect direct children of this station.

Returns:

the action or null if this feature should be disabled, or the action is set later

setFullScreenAction

public void setFullScreenAction(ListeningDockAction fullScreenAction)

Sets an action which allows to expand children. This method can only be invoked if there is not already set an action. It is a condition that createFullScreenAction() returns null

Parameters:

fullScreenAction - the new action

Throws:

IllegalStateException - if there is already an action present

setExpandOnDoubleclick

public void setExpandOnDoubleclick(boolean expandOnDoubleclick)

Sets whether a double click on a child or its title can expand the child to fullscreen or not.

Parameters:

expandOnDoubleclick - true if the double click should have an effect, false if double clicks should be ignored.

isExpandOnDoubleclick

public boolean isExpandOnDoubleclick()

Tells whether a child expands to fullscreen when double clicked or not.

Returns:

true if a double click has an effect, false otherwise

See Also:

setExpandOnDoubleclick(boolean)

setResizingEnabled

public void setResizingEnabled(boolean resizingEnabled)

Enables the user to resize the children of this station. The default value of this property is true. Note that resizing is a core functionality of this station, disabling it should be considered carefully.

Parameters:

resizingEnabled - whether resizing is enabled or not

isResizingEnabled

public boolean isResizingEnabled()

Tells whether the user can drag dividiers and resize dockables in this way.

Returns:

true if resizing is allowed

setDisabled

protected void setDisabled(boolean disabled)

Called by the current DisablingStrategy when this station changes its state.

Parameters:

disabled - whether the station is enabled or not

isDisabled

public boolean isDisabled()

Tells the result of the current DisablingStrategy.

Returns:

whether this station is currently enabled or not

setDockParent

public void setDockParent(DockStation station)

Description copied from interface: Dockable

Sets the parent property. This Dockable is shown as direct child of station.
Note: this method has to fire a DockHierarchyEvent.
Note: when using a DockHierarchyObserver, invoke DockHierarchyObserver.update() after the property has changed, it will automatically fire a DockHierarchyEvent if necessary.

Specified by:

setDockParent in interface Dockable

Parameters:

station - the parent, may be null if this Dockable is not visible at all.

getDockParent

public DockStation getDockParent()

Description copied from interface: Dockable

Gets the current parent, which is the latest argument of Dockable.setDockParent(DockStation).

Specified by:

getDockParent in interface Dockable

Returns:

the parent property, can be null

setController

public void setController(DockController controller)

Description copied from class: SecureContainer

Sets the controller which tells whether a restricted environment is in use.

Specified by:

setController in interface Dockable

Specified by:

setController in interface DockStation

Overrides:

setController in class SecureContainer

Parameters:

controller - the controller to inform about MouseEvents or null

getController

public DockController getController()

Description copied from class: SecureContainer

Gets the controller which tells whether a restricted environment is in use.

Specified by:

getController in interface DockElement

Specified by:

getController in interface Dockable

Specified by:

getController in interface DockStation

Overrides:

getController in class SecureContainer

Returns:

the controller or null

See Also:

DockStation.setController(DockController)

getComponentConfiguration

public DockComponentConfiguration getComponentConfiguration()

Description copied from interface: DockComponentRoot

Gets the currently applied configuration.

Specified by:

getComponentConfiguration in interface DockComponentRoot

Returns:

the current configuration, may be null

setComponentConfiguration

public void setComponentConfiguration(DockComponentConfiguration configuration)

Description copied from interface: DockComponentRoot

Sets a configuration which is to be applied to all Components (and maybe their children) of this DockComponentRoot.

Specified by:

setComponentConfiguration in interface DockComponentRoot

Parameters:

configuration - the new configuration or null.

addDockableListener

public void addDockableListener(DockableListener listener)

Description copied from interface: Dockable

Adds a listener to this Dockable. The listener has to be informed if a property of this Dockable changes.

Specified by:

addDockableListener in interface Dockable

Parameters:

listener - the new listener

removeDockableListener

public void removeDockableListener(DockableListener listener)

Description copied from interface: Dockable

Removes a listener from this Dockable.

Specified by:

removeDockableListener in interface Dockable

Parameters:

listener - the listener to remove

addDockHierarchyListener

public void addDockHierarchyListener(DockHierarchyListener listener)

Description copied from interface: Dockable

Adds a hierarchy-listener to this Dockable. The listener has to be informed whenever the path to this Dockable has been changed.
Subclasses might use the DockHierarchyObserver to implement this feature in an easy way. Subclasses then only have to call DockHierarchyObserver.update() whenever the parent of this Dockable changes.
Note: when using a DockHierarchyObserver, forward the call directly to DockHierarchyObserver.addDockHierarchyListener(DockHierarchyListener)

Specified by:

addDockHierarchyListener in interface Dockable

Parameters:

listener - the new listener

removeDockHierarchyListener

public void removeDockHierarchyListener(DockHierarchyListener listener)

Description copied from interface: Dockable

Removes a hierarchy-listener from this Dockable.
Note: when using a DockHierarchyObserver, forward the call directly to DockHierarchyObserver.removeDockHierarchyListener(DockHierarchyListener)

Specified by:

removeDockHierarchyListener in interface Dockable

Parameters:

listener - the listener to remove

See Also:

Dockable.addDockableListener(DockableListener)

addMouseInputListener

public void addMouseInputListener(MouseInputListener listener)

Description copied from interface: Dockable

Adds a MouseInputListener to the component of this Dockable. A Dockable has to decide by itself which Components should be observer, but generally all free areas should be covered. It's also possible just to ignore the listener, but that's not the preferred behavior.

Specified by:

addMouseInputListener in interface DockElementRepresentative

Specified by:

addMouseInputListener in interface Dockable

Parameters:

listener - the mouse listener

removeMouseInputListener

public void removeMouseInputListener(MouseInputListener listener)

Description copied from interface: Dockable

Removes a listener that was earlier added to this Dockable.

Specified by:

removeMouseInputListener in interface DockElementRepresentative

Specified by:

removeMouseInputListener in interface Dockable

Parameters:

listener - The listener to remove

accept

public boolean accept(DockStation station)

Description copied from interface: Dockable

Tells whether station is an accepted parent for this Dockable or not. The user is not able to drag a Dockable to a station which is not accepted.

Specified by:

accept in interface Dockable

Parameters:

station - a possible parent

Returns:

whether station could be a parent or not

accept

public boolean accept(DockStation base,
                      Dockable neighbour)

Description copied from interface: Dockable

Tells whether base could be the parent of a combination between this Dockable and neighbor. The user is not able to make a combination between this Dockable and neighbor if this method does not accept the operation.

Specified by:

accept in interface Dockable

Parameters:

base - the future parent of the combination

neighbour - a Dockable whose parent will be the same parent as the parent of this Dockable

Returns:

true if the combination is allowed, false otherwise

getComponent

public Component getComponent()

Description copied from interface: Dockable

Gets the Component which represents this Dockable. Note that the component should be a focus cycle root

Specified by:

getComponent in interface DockElementRepresentative

Specified by:

getComponent in interface Dockable

Returns:

the visible representation

getElement

public DockElement getElement()

Description copied from interface: DockElementRepresentative

Gets the element which is represented by this. The result of this method must not change.

Specified by:

getElement in interface DockElementRepresentative

Returns:

the element, never null

isUsedAsTitle

public boolean isUsedAsTitle()

Description copied from interface: DockElementRepresentative

Tells whether this DockElementRepresentative is used as title.
Some modules grant more rights to titles than to non-titles, i.e. a DockRelocator can allow drag & drop only for titles.
Normally a Dockable should have only one element that is a title, so if in doubt return false.

Specified by:

isUsedAsTitle in interface DockElementRepresentative

Returns:

true if this representative should be seen as title

shouldFocus

public boolean shouldFocus()

Description copied from interface: DockElementRepresentative

Tells whether a click onto this component should transfer the focus either to this component or to the Dockable.

Specified by:

shouldFocus in interface DockElementRepresentative

Returns:

true if clicking this component should influence focus

shouldTransfersFocus

public boolean shouldTransfersFocus()

Description copied from interface: DockElementRepresentative

Tells whether a click onto this component should transfer the focus to the Dockable or not. If this object is a Dockable, then a result of true might change the currently focused item of itself. This property is ignored if DockElementRepresentative.shouldFocus() returns false.

Specified by:

shouldTransfersFocus in interface DockElementRepresentative

Returns:

whether to change the focused component or not

getPopupLocation

public Point getPopupLocation(Point click,
                              boolean popupTrigger)

Description copied from interface: DockElementRepresentative

Tells whether a popup menu should be opened when the user clicks at click with the mouse. If yes, then the top left edge of the popup should be returned, otherwise null should be returned.

Specified by:

getPopupLocation in interface DockElementRepresentative

Parameters:

click - the location where the user clicked with the mouse

popupTrigger - whether the invocation is the systems popup trigger or not. Many implementations of this method will return click in case of true, and null in case of false

Returns:

the preferred location of a popup or null if no popup-menu should be opened

getTitleText

public String getTitleText()

Description copied from interface: Dockable

Gets the current title-text of this Dockable.

Specified by:

getTitleText in interface Dockable

Returns:

the text

setTitleText

public void setTitleText(String titleText)

Sets the text of the title of this dockable.

Parameters:

titleText - the text displayed in the title

getTitleToolTip

public String getTitleToolTip()

Description copied from interface: Dockable

Gets a tooltip that is associated with this Dockable and that should be shown on any DockTitle.

Specified by:

getTitleToolTip in interface Dockable

Returns:

the tooltip, can be null

setTitleToolTip

public void setTitleToolTip(String text)

Sets the tooltip that should be shown on any title that is bound to this dockable.

Parameters:

text - the tooltip, can be null

getTitleIcon

public Icon getTitleIcon()

Description copied from interface: Dockable

Gets the current icon of this Dockable.

Specified by:

getTitleIcon in interface Dockable

Returns:

the icon, may be null

setTitleIcon

public void setTitleIcon(Icon titleIcon)

Sets an icon that is shown in the titles of this Dockable.

Parameters:

titleIcon - the icon or null

resetTitleIcon

public void resetTitleIcon()

Resets the icon of this SplitDockStation, the default icon is shown again.

setSplitLayoutManager

public void setSplitLayoutManager(SplitLayoutManager manager)

Sets a special SplitLayoutManager which this station has to use.

Parameters:

manager - the manager or null to return to the manager that is specified in the DockProperties by the key LAYOUT_MANAGER.

getSplitLayoutManager

public SplitLayoutManager getSplitLayoutManager()

Gets the layout manager which was explicitly set.

Returns:

the manager or null

See Also:

setSplitLayoutManager(SplitLayoutManager), getCurrentSplitLayoutManager()

getCurrentSplitLayoutManager

public SplitLayoutManager getCurrentSplitLayoutManager()

Gets the SplitLayoutManager that is currently used by this station.

Returns:

the currently used layout manager

See Also:

setSplitLayoutManager(SplitLayoutManager)

getPlaceholderStrategy

public RootPlaceholderStrategy getPlaceholderStrategy()

Gets the strategy for creating and storing placeholders. Note that this is not the same value as was set to setPlaceholderStrategy(PlaceholderStrategy)

Returns:

the strategy, never null

setPlaceholderStrategy

public void setPlaceholderStrategy(PlaceholderStrategy strategy)

Sets the strategy for selecting placeholders when removing Dockables from this station.

Parameters:

strategy - the new strategy or null to install the default strategy

setSideSnapSize

public void setSideSnapSize(float sideSnapSize)

Every child has an invisible border whose size is determined by sideSnapSize. If another Dockable is dragged into that border, it is added as neighbor. Otherwise it is merged with the present child.

Parameters:

sideSnapSize - the relative size of the border, should be between 0 and 0.5f

Throws:

IllegalArgumentException - if the size is less than 0

getSideSnapSize

public float getSideSnapSize()

Gets the relative size of the invisible border of all children.

Returns:

the size

See Also:

setSideSnapSize(float)

setBorderSideSnapSize

public void setBorderSideSnapSize(int borderSideSnapSize)

There is an invisible border around the station. If a Dockable is dragged inside this border, its considered to be on the station, but will be dropped aside the station (like the whole station is a neighbor of the Dockable).

Parameters:

borderSideSnapSize - the size of the border in pixel

Throws:

IllegalArgumentException - if the size is smaller than 0

getBorderSideSnapSize

public int getBorderSideSnapSize()

Gets the size of the border around the station.

Returns:

the size in pixel

See Also:

setBorderSideSnapSize(int)

setDividerSize

public void setDividerSize(int dividerSize)

Sets the size of the divider-gap between the children of this station.

Parameters:

dividerSize - the size of the gap in pixel

Throws:

IllegalArgumentException - if the size is less than 0.

getDividerSize

public int getDividerSize()

Gets the size of the divider-gap.

Returns:

the size

See Also:

setDividerSize(int)

getDividerStrategy

public SplitDividerStrategy getDividerStrategy()

Gets the SplitDividerStrategy that is used to handle the divider of this station.

Returns:

the current strategy

setDividerStrategy

public void setDividerStrategy(SplitDividerStrategy strategy)

Sets the SplitDividerStrategy that should be used to handle the divider of this station.

Parameters:

strategy - the new strategy or null to revert to the default value

getSpanStrategy

protected SplitSpanStrategy getSpanStrategy()

Gets read access to the strategy which is responsible for handling the Spans of this station.

Returns:

the object responsible for handling Spans, not null

setNodeFactory

@FrameworkOnly
public void setNodeFactory(SplitNodeFactory factory)

Sets the factory which is responsible for creating new SplitNodes. Clients usually have no need to change this property.

Parameters:

factory - the new factory, must not be null

getNodeFactory

@FrameworkOnly
public SplitNodeFactory getNodeFactory()

Gets the factory which is responsible for creating new SplitNodes. Clients usually have no need to access this property.

Returns:

the current factory, not null

setContinousDisplay

public void setContinousDisplay(boolean continousDisplay)

Sets whether the dockables should be resized while the split is dragged, or not.

Parameters:

continousDisplay - true if the dockables should be resized

isContinousDisplay

public boolean isContinousDisplay()

Tells whether the dockables are resized while the split is dragged, or not.

Returns:

true if the dockables are resized

See Also:

setContinousDisplay(boolean)

setMinimumLeafSize

public void setMinimumLeafSize(Dimension minimumLeafSize)

Sets the minimum size a Leaf can have. The default is 20/20.

Parameters:

minimumLeafSize - the new minimum size in pixels, not null

getMinimumLeafSize

public Dimension getMinimumLeafSize()

Gets the minimum size a Leaf can have.

Returns:

the minimum size

setAllowSideSnap

public void setAllowSideSnap(boolean allowSideSnap)

Sets whether Dockables which are dragged near the station are captured and added to this station.

Parameters:

allowSideSnap - true if the station can snap Dockables which are near.

See Also:

setBorderSideSnapSize(int)

isAllowSideSnap

public boolean isAllowSideSnap()

Tells whether the station can grab Dockables which are dragged near the station.

Returns:

true if grabbing is allowed

See Also:

setAllowSideSnap(boolean)

requestDockTitle

public void requestDockTitle(DockTitleRequest request)

Description copied from interface: Dockable

Invoked to get a graphical representation of a title for this Dockable. This method is called either when a title first is required, or when this Dockable invoked the DockableListener.titleExchanged(Dockable, DockTitle) method of its current observers.
This Dockable might decide to answer the request by calling DockTitleRequest.answer(DockTitle), any title, including null are valid answers. If this Dockable does not answer the request the associated DockTitleFactory (as described by DockTitleVersion.getFactory()) is asked to answer the request.
The requests target must be this Dockable.
The normal behavior of this method is to do nothing.

Specified by:

requestDockTitle in interface Dockable

Parameters:

request - which title is required. If this Dockable does not have a special rule for the given request it just ignores the call

requestDisplayer

public void requestDisplayer(DisplayerRequest request)

Description copied from interface: Dockable

Invoked to get DockableDisplayer for this Dockable. This method may be called when this Dockable is dropped onto a new DockStation, a theme was exchanged, or an existing DockableDisplayer was discarded.
The usual behavior of this method should be to do nothing.

Specified by:

requestDisplayer in interface Dockable

Parameters:

request - callback used to set a new DockableDisplayer

changed

public void changed(Dockable dockable,
                    DockTitle title,
                    boolean active)

Description copied from interface: DockStation

Called by the DockController of this station to indicate that the active-state of title has been changed. This station should call the method title.changed with an appropriate event. The station may add some additional information to this call.

Specified by:

changed in interface DockStation

Parameters:

dockable - the child whose title is changed

title - the changed title, may not be bound

active - the new state of the title

requestChildDockTitle

public void requestChildDockTitle(DockTitleRequest request)

Description copied from interface: DockStation

Provides a DockTitle for a child of this station. This method must call DockTitleRequest.answer(DockTitle) to set the result.
Most DockStations won't have the need to implement this method, leaving it empty will advice the framework to use another source for new DockTitles.

Specified by:

requestChildDockTitle in interface DockStation

Parameters:

request - the request to answer, not null

requestChildDisplayer

public void requestChildDisplayer(DisplayerRequest request)

Description copied from interface: DockStation

Provides a DockableDisplayer for a child of this station. This method must call DisplayerRequest.answer(DockableDisplayer) to set the result.
The usual implementation should be to do nothing.

Specified by:

requestChildDisplayer in interface DockStation

Parameters:

request - the request to answer, not null

bind

public void bind(DockTitle title)

Description copied from interface: Dockable

Called by clients which want to show a title of this Dockable. The method DockTitle.bind() will be called automatically by the controller.
This method must at least inform all listeners, that title was bound. However, the method DockTitle.bind() must not be invoked by this method.
title must be returned by Dockable.listBoundTitles() unless Dockable.unbind(DockTitle) is called.

Specified by:

bind in interface Dockable

Parameters:

title - the title which will be show some things of this Dockable

See Also:

Dockable.unbind(DockTitle)

unbind

public void unbind(DockTitle title)

Description copied from interface: Dockable

Clients should call this method if a DockTitle is no longer needed. The controller will call DockTitle.unbind() at an appropriate time.
This method must inform all listeners that title is no longer bound. However, this method must not call DockTitle.unbind().
title must no longer be returned when calling Dockable.listBoundTitles()

Specified by:

unbind in interface Dockable

Parameters:

title - the title which will be no longer connected to this Dockable

See Also:

Dockable.bind(DockTitle)

listBoundTitles

public DockTitle[] listBoundTitles()

Description copied from interface: Dockable

Gets a list of all DockTitles which are currently bound to this Dockable. That are titles for which Dockable.bind(DockTitle) was called, but not yet Dockable.unbind(DockTitle).

Specified by:

listBoundTitles in interface Dockable

Returns:

the list of titles

getLocalActionOffers

public DockActionSource getLocalActionOffers()

Description copied from interface: Dockable

Gets a list of DockActions which should be triggerable if this Dockable is visible. The list contains only actions which are directly bound to this Dockable (the actions which are not changed when the parent-station of this Dockable is exchanged). The list can be modified by this Dockable at every time, clients have to react on these changes by adding a DockActionSourceListener to the result.

Specified by:

getLocalActionOffers in interface Dockable

Returns:

the source of actions, can be null if no actions are available

getGlobalActionOffers

public DockActionSource getGlobalActionOffers()

Description copied from interface: Dockable

Gets a list of all DockActions which might be triggered while this Dockable is visible. The list must contain all actions which are related in any way to this Dockable. Subclasses might use a HierarchyDockActionSource or the method DockController.listOffers(Dockable) to implement this functionality

Specified by:

getGlobalActionOffers in interface Dockable

Returns:

the source containing all actions, never null

configureDisplayerHints

public void configureDisplayerHints(DockableDisplayerHints hints)

Description copied from interface: Dockable

Orders this Dockable to configure hints which will be used by the parent component of this element. This Dockable can store a reference to hints and use it to change the hints whenever it is appropriate. This method will be called with null if the link should be broken.

Specified by:

configureDisplayerHints in interface Dockable

Parameters:

hints - the hints to configure or null if the last hints should no longer be configured by this element

getConfigurableDisplayerHints

protected DockableDisplayerHints getConfigurableDisplayerHints()

Gets the argument that was last used for configureDisplayerHints(DockableDisplayerHints).

Returns:

the configurable hints or null

updateConfigurableDisplayerHints

protected void updateConfigurableDisplayerHints()

Updates the current hints of this station.

asDockStation

public DockStation asDockStation()

Description copied from interface: DockElement

Returns this if this is an instance of DockStation. Otherwise null is returned.

Specified by:

asDockStation in interface DockElement

Returns:

this or null. Must not return null if DockElement.asDockable() already returns null

getDirectActionOffers

public DefaultDockActionSource getDirectActionOffers(Dockable dockable)

Description copied from interface: DockStation

Gets a list of actions which should be available for the user and affect the child dockable.

Specified by:

getDirectActionOffers in interface DockStation

Parameters:

dockable - a child of this station

Returns:

actions for dockable, can be null

getIndirectActionOffers

public DockActionSource getIndirectActionOffers(Dockable dockable)

Description copied from interface: DockStation

Gets a list of actions which should be available for the user and affect dockable. The argument dockable can be a child of this station, or a child of any station which is below this station.

Specified by:

getIndirectActionOffers in interface DockStation

Parameters:

dockable - a child of this station or a child of another station which is below this station

Returns:

actions for dockable or null

addDockStationListener

public void addDockStationListener(DockStationListener listener)

Description copied from interface: DockStation

Adds a listener to this station. The station has to invoke the methods of the listener such that its requirements are full filled.

Specified by:

addDockStationListener in interface DockStation

Parameters:

listener - the listener to add

removeDockStationListener

public void removeDockStationListener(DockStationListener listener)

Description copied from interface: DockStation

Removes a listener from this station.

Specified by:

removeDockStationListener in interface DockStation

Parameters:

listener - the listener to remove

addDockableStateListener

public void addDockableStateListener(DockableStateListener listener)

Description copied from interface: Dockable

Adds listener to this Dockable. The listener will be informed about various events concerning the position and visibility of this dockable.

Specified by:

addDockableStateListener in interface Dockable

Parameters:

listener - the new listener, not null

removeDockableStateListener

public void removeDockableStateListener(DockableStateListener listener)

Description copied from interface: Dockable

Removes listener from this element.

Specified by:

removeDockableStateListener in interface Dockable

Parameters:

listener - the listener to remove

addSplitDockStationListener

public void addSplitDockStationListener(SplitDockListener listener)

Adds a listener to this station. The listener is informed some settings only available to a SplitDockStation are changed.

Parameters:

listener - the new listener

removeSplitDockStationListener

public void removeSplitDockStationListener(SplitDockListener listener)

Removes an earlier added listener.

Parameters:

listener - The listener to remove

isChildShowing

public boolean isChildShowing(Dockable dockable)

Description copied from interface: DockStation

Tells whether the child dockable is visible or not. Visible means that the component of dockable can be seen by the user. The result must be false if this station is not visible.

Specified by:

isChildShowing in interface DockStation

Parameters:

dockable - the child whose visibility-state is questioned

Returns:

whether dockable is visible or not

See Also:

DockStation.isStationVisible()

isVisible

@Deprecated
@Todo(compatibility=BREAK_MAJOR,
      priority=ENHANCEMENT,
      target=VERSION_1_1_3,
      description="remove this method")
public boolean isVisible(Dockable dockable)

Deprecated.

Description copied from interface: DockStation

Tells whether the child dockable is visible or not. Visible means that the component of dockable can be seen by the user. The result must be false if this station is not visible.

Specified by:

isVisible in interface DockStation

Parameters:

dockable - the child whose visibility-state is questioned

Returns:

whether dockable is visible or not

See Also:

DockStation.isStationVisible()

isStationShowing

public boolean isStationShowing()

Description copied from interface: DockStation

Tells whether this station is visible or not. For example a station on a JFrame is not visible if the frame is minimized.

Specified by:

isStationShowing in interface DockStation

Returns:

whether this station is visible

isStationVisible

@Deprecated
@Todo(compatibility=BREAK_MAJOR,
      priority=ENHANCEMENT,
      target=VERSION_1_1_3,
      description="remove this method")
public boolean isStationVisible()

Deprecated.

Description copied from interface: DockStation

Tells whether this station is visible or not. For example a station on a JFrame is not visible if the frame is minimized.

Specified by:

isStationVisible in interface DockStation

Returns:

whether this station is visible

isDockableShowing

public boolean isDockableShowing()

Description copied from interface: Dockable

Tells whether this Dockable can be seen by the user. A Dockable at least needs to be registered as root-station on a DockController, or be a child of a root-station to be visible.
Implementations will assume that Components which are displayable are are visible to the user.

Specified by:

isDockableShowing in interface Dockable

Returns:

true if the user can actually see this dockable, false otherwise

isDockableVisible

@Deprecated
@Todo(compatibility=BREAK_MAJOR,
      priority=ENHANCEMENT,
      target=VERSION_1_1_3,
      description="remove this method")
public boolean isDockableVisible()

Deprecated.

Description copied from interface: Dockable

Tells whether this Dockable can be seen by the user. A Dockable at least needs to be registered as root-station on a DockController, or be a child of a root-station to be visible.
Implementations will assume that Components which are displayable are are visible to the user.

Specified by:

isDockableVisible in interface Dockable

Returns:

true if the user can actually see this dockable, false otherwise

getDockableCount

public int getDockableCount()

Description copied from interface: DockStation

Gets the number of children.

Specified by:

getDockableCount in interface DockStation

Returns:

the number of children on this station

getDockable

public Dockable getDockable(int index)

Description copied from interface: DockStation

Gets the index'th child of this station.

Specified by:

getDockable in interface DockStation

Parameters:

index - a value between 0 (incl.) and DockStation.getDockableCount() (excl.).

Returns:

a child of this station

getDockableProperty

public DockableProperty getDockableProperty(Dockable child,
                                            Dockable target)

Description copied from interface: DockStation

Gets precise information about the location of a child of this station. The result of this method could later be used to invoke DockStation.drop(Dockable, DockableProperty).

Specified by:

getDockableProperty in interface DockStation

Parameters:

child - a child of this station, this childs location is asked

target - an optional hint telling for which dockable the location information will be used, can be null. This hint can be used to find a placeholder that should be part of the result.

Returns:

the location

See Also:

DockUtilities.getPropertyChain(DockStation, Dockable)

aside

public void aside(AsideRequest request)

Description copied from interface: DockStation

Requests this DockStation to find a DockableProperty that is "aside" another property. What exactly the meaning of "aside" is, is left to the implementation. Usually "aside" means on the same "stack" but with the next higher index.
The request object contains information about the location whose neighbor is searched, about a placeholder that should be used for the new location, and offers methods to forward the call to the next DockStation or Combiner if there is a successor.
This method should call the answer methods of request with every kind of information it finds.
If this method cannot handle request, then it just has to return without calling any of the answer methods.

Specified by:

aside in interface DockStation

Parameters:

request - information about a location and methods to create the neighbor location

See Also:

Combiner.aside(AsideRequest)

getDockablePathProperty

public SplitDockPathProperty getDockablePathProperty(Dockable dockable)

Creates a DockableProperty for the location of dockable. The location is encoded as the path through the tree to get to dockable.

Parameters:

dockable - the element whose location is searched

Returns:

the location

getDockablePathProperty

public SplitDockPathProperty getDockablePathProperty(Path placeholder)

Creates a DockableProperty pointing to the leaf containing placeholder.

Parameters:

placeholder - the placeholder to search, not null

Returns:

the path to placeholder or null if placeholder was not found

getDockableLocationProperty

public SplitDockProperty getDockableLocationProperty(Dockable dockable)

Creates a DockableProperty for the location of dockable. The location is encoded directly as the coordinates x,y,width and height of the dockable.

Parameters:

dockable - the element whose location is searched

Returns:

the location

getDockablePlaceholderProperty

public SplitDockPlaceholderProperty getDockablePlaceholderProperty(Dockable dockable,
                                                                   Dockable target)

Creates a SplitDockPlaceholderProperty for dockable, may insert an additional placeholder in the tree.

Parameters:

dockable - the element whose location is searched

target - hint required to find the placeholder

Returns:

the placeholder or null if the strategy did not assign a placeholder to dockable

getFrontDockable

public Dockable getFrontDockable()

Description copied from interface: DockStation

Gets the favorite child of this station. The favorite child is the one child which is specially designated for the user. An example: if the station behaves like a stack, and only the top child is visible, then the favorite child could the the top.
A result of null indicates that there are no children at all, or that there is no favorite child (all children are equal important).
Stations should not change this property directly, they should call DockController.setFocusedDockable(Dockable, boolean) which will then call DockStation.setFrontDockable(Dockable). Note that the DockController itself listens to the DockTitles, and maybe the station doesn't need a logic to decide which child is important.

Specified by:

getFrontDockable in interface DockStation

Returns:

the most important child or null

setFrontDockable

public void setFrontDockable(Dockable dockable)

Description copied from interface: DockStation

Sets the most important child. The station should ensure that this child is visible (assuming the station itself is visible). Read the comment on DockStation.getFrontDockable() how stations can change this property.

Specified by:

setFrontDockable in interface DockStation

Parameters:

dockable - the new favorite child, can be null

See Also:

DockStation.getFrontDockable()

isFullScreen

public boolean isFullScreen()

Tells whether a Dockable is currently shown in fullscreen-mode on this station. A true result implies that getFullScreen() returns not null.

Returns:

true if a child is fullscreen.

getFullScreen

public Dockable getFullScreen()

Gets the Dockable which is in fullscreen-mode and covers all other children of this station.

Returns:

the child or null

See Also:

setFullScreen(Dockable), isFullScreen()

hasFullScreenAction

public boolean hasFullScreenAction()

Tells whether createFullScreenAction() was called and returned a value other than null.

Returns:

true if this station shows a fullscreen-action

setFullScreen

public void setFullScreen(Dockable dockable)

Sets one of the children of this station as the one child which covers all other children. This child is in "fullscreen"-mode.

Parameters:

dockable - a child of this station or null if all children should be visible.

See Also:

isFullScreen()

updateVisibility

protected void updateVisibility()

Calls Component.setVisible(boolean) on all current children and updates the visibility. depending on whether there is a fullscreen-dockable or not.

setNextFullScreen

public void setNextFullScreen()

Switches the child which is in fullscreen-mode. If there is no child, nothing will happen. If there is only one child, it will be set to fullscreen (if it is not already fullscreen).

accept

public boolean accept(Dockable child)

Description copied from interface: DockStation

Tells whether this station accepts child as a new child, or refuses child. The user will not be able to drop a Dockable onto this station if this method returns false.

Specified by:

accept in interface DockStation

Parameters:

child - a Dockable which may become a child

Returns:

true if child is accepted

getPlaceholderMapping

public PlaceholderMapping getPlaceholderMapping()

Description copied from interface: DockStation

Allows access to the placeholders that are stored on this station. Clients may use the PlaceholderMapping to add or remove placeholders from the station.
Not all stations support placeholders, and these station may return a mapping that performs no actions.

Specified by:

getPlaceholderMapping in interface DockStation

Returns:

access to the placeholders

getPlaceholders

public PlaceholderMap getPlaceholders()

Description copied from interface: DockStation

Gets a snapshot of all placeholders that are currently stored in this DockStation. A DockStation is free in the format it chooses to fill the map. The map is to be created with the assumptions that DockStation.getDockableCount() is 0, meaning any existing Dockable gets replaced by its placeholder. The current PlaceholderStrategy should be used to convert Dockables to placeholders.
Clients interested in modifying the placeholders of this station should call DockStation.getPlaceholderMapping().

Specified by:

getPlaceholders in interface DockStation

Returns:

the map of placeholders or null if this station does not support placeholders

setPlaceholders

public void setPlaceholders(PlaceholderMap placeholders)

Description copied from interface: DockStation

Sets an earlier snapshot of the placeholders of this station. This station can assume that it currently does not have any children (that DockStation.getDockableCount() is 0).
This method does nothing if it cannot handle the format or the version of placeholders.

Specified by:

setPlaceholders in interface DockStation

Parameters:

placeholders - some set of placeholders

createPlaceholderConverter

protected SplitPlaceholderConverter createPlaceholderConverter()

Creates the algorithm that is used by getPlaceholders() and setPlaceholders(PlaceholderMap).

Returns:

the algorithm to handle PlaceholderMaps, not null

getLayers

public DockStationDropLayer[] getLayers()

Description copied from interface: DockStation

Gets a description of all the areas of the screen where this DockStation can handle a drop event.
Everytime the mouse is moved or released during a drag & drop operation, this method is called for all DockStations. The returned DockStationDropLayers are then filtered and ordered, the resulting order defines the order in which the method DockStation.prepareDrop(StationDropItem) is called.

Specified by:

getLayers in interface DockStation

Returns:

all the layers of this station, must not be null, must not contain null, must not contain the same entry twice. The array or the DockStationDropLayers may be modified, hence this method should always create new objects.

prepareDrop

public StationDropOperation prepareDrop(StationDropItem item)

Description copied from interface: DockStation

Prepares this station to get the new child dockable or to move around the known child dockable. The station can refuse dockable, in this case this method just returns null. There are some constraints:

• This method should use DockStation.accept(Dockable) and Dockable.accept(DockStation) or Dockable.accept(DockStation, Dockable) to ensure that the desired drop-location is valid.
• The method should use the DockAcceptance of its controller (see DockController.getAcceptance()) to ensure that the drop/location is valid.

Specified by:

prepareDrop in interface DockStation

Parameters:

item - information about the dockable that is going to be dropped

Returns:

an object describing where the Dockable can be dropped or null if no drop operation is possible

prepareDrag

public StationDragOperation prepareDrag(Dockable dockable)

Description copied from interface: DockStation

Informs this station that a drag and drop operation is in progress and that dockable might be removed from this station.

Specified by:

prepareDrag in interface DockStation

Parameters:

dockable - the child that might be removed in the near future

Returns:

a callback that will be informed when the dockable was removed or the operation canceleled, can be null

getDropInfo

public PutInfo getDropInfo()

Gets the location where the currently dragged Dockable would be dropped.

Returns:

a possible location, may be null

setDropInfo

protected void setDropInfo(PutInfo putInfo)

Sets the current information telling where and how an item is to be dropped.

Parameters:

putInfo - the current drop information

setPut

protected void setPut(PutInfo putInfo)

Forward call to SplitSpanStrategy.setPut(PutInfo).

Parameters:

putInfo - the new information about where an item is about to be dropped

unsetDropInfo

protected void unsetDropInfo()

Resets the information telling where and how an item is to be dropped.

unsetPut

protected void unsetPut()

Forward call to SplitSpanStrategy.unsetPut().

drop

public void drop(Dockable dockable)

Description copied from interface: DockStation

Adds dockable to this station. The station can decide by its own where to put dockable.

Specified by:

drop in interface DockStation

Parameters:

dockable - a new child

drop

public boolean drop(Dockable dockable,
                    DockableProperty property)

Description copied from interface: DockStation

Tries to add dockable to this station such that the location given by property is matched. If property has a successor and points to another station, just call the drop-method of this child-station. Note that property can be of any type and contain invalid information.

Specified by:

drop in interface DockStation

Parameters:

dockable - the new child

property - the location of the child, may be invalid data

Returns:

true if property could be read and dockable was dropped, false otherwise.

drop

public boolean drop(Dockable dockable,
                    SplitDockProperty property)

Tries to add Dockable such that the boundaries given by property are full filled.

Parameters:

dockable - a new child of this station

property - the preferred location of the child

Returns:

true if the child could be added, false if no location could be found

getDropInfo

protected bibliothek.gui.dock.SplitDockStation.DropInfo getDropInfo(SplitDockProperty property,
                                                                    Dockable dockable,
                                                                    SplitNode root)

Searches for the best place for dockable such that its boundaries met property.

Parameters:

property - the location of dockable

dockable - the element to place, can be null

root - a node that must be part of the path for dockable

Returns:

the best place for dockable

drop

public boolean drop(Dockable dockable,
                    SplitDockPathProperty property)

Tries to insert dockable at a location such that the path to that location is the same as described in property.

Parameters:

dockable - the element to insert

property - the preferred path to the element

Returns:

true if the element was successfully inserted

getLowestNode

protected Tuple<Integer,SplitNode> getLowestNode(SplitDockPathProperty property)

Searches the lowest node whose identifier is equal to an identifier from property. In the best case scenario this method directly returns the Leaf to which property points.

Parameters:

property - a path in which a SplitNode is searched

Returns:

The node closest to the leaf and in property, can be the root(). And the index of the node for calling SplitDockPathProperty.getNode(int).s

drop

public boolean drop(Dockable dockable,
                    SplitDockPlaceholderProperty property)

Drops dockable at the placeholder that is referenced by property. This action removes the placeholder from the tree.

Parameters:

dockable - the element to add

property - the location of dockable

Returns:

true if the the operation was a success, false if not

drop

public boolean drop(Dockable dockable,
                    SplitDockFullScreenProperty property)

Drops dockable on this station, may exchange the full screen element to ensure that dockable is displayed.

Parameters:

dockable - the element to drop

property - the location of dockable

Returns:

true if the operation was a success, false if not

dropOver

protected boolean dropOver(Leaf leaf,
                           Dockable dockable,
                           CombinerSource source,
                           CombinerTarget target)

Combines the Dockable of leaf and dockable to a new child of this station. No checks whether the two elements accepts each other nor if the station accepts the new child dockable are performed.

Parameters:

leaf - the leaf which will be combined with dockable

dockable - a Dockable which is dropped over leaf

source - information about the combination, may be null

target - information about the combination, may be null

Returns:

true if the operation was successful, false otherwise

dropOver

protected boolean dropOver(Leaf leaf,
                           Dockable dockable,
                           DockableProperty property,
                           CombinerSource source,
                           CombinerTarget target)

Combines the Dockable of leaf and dockable to a new child of this station. No checks whether the two elements accepts each other nor if the station accepts the new child dockable are performed.

Parameters:

leaf - the leaf which will be combined with dockable

dockable - a Dockable which is dropped over leaf

property - a hint at which position dockable should be in the combination.

source - information about the combination, may be null

target - information about the combination, may be null

Returns:

true if the operation was successful, false otherwise

dropAside

protected boolean dropAside(SplitNode neighbor,
                            PutInfo.Put put,
                            Dockable dockable,
                            Leaf leaf,
                            double divider,
                            DockHierarchyLock.Token token)

Adds dockable at the side put of neighbor. The divider is set to the value of divider, and if fire is activated, some events are fired. There are no checks whether dockable accepts this station or anything else.

Parameters:

neighbor - The node which will be the neighbor of dockable

put - The side on which dockable should be added in respect to neighbor.

dockable - the new child of this station

leaf - the leaf which contains dockable, can be null

divider - the divider-location, a value between 0 and 1

token - if null, then a token will be acquired by this method and this method will fire events, otherwise this methods is executed silently

Returns:

true if the operation was a success, false otherwise

move

public void move(Dockable dockable,
                 DockableProperty property)

Description copied from interface: DockStation

Tries to move the child dockable in such a way, that DockStation.getDockableProperty(Dockable, Dockable) would return a DockableProperty that equals property.
There is no need to give a guarantee that the move successes, and clients should always be prepared for the possibility that this DockStation does nothing at all.

Specified by:

move in interface DockStation

Parameters:

dockable - a child of this station

property - the preferred position of dockable

dropGrid

public void dropGrid(SplitDockGrid grid)

Copies the layout of grid. Any changes to grid afterwards will not affect this station, nor will changes on this station affect grid.

Parameters:

grid - the layout to drop, not null

See Also:

dropTree(SplitDockTree)

dropTree

public void dropTree(SplitDockTree<Dockable> tree)

Removes all children from this station and then adds the contents that are stored in tree. Calling this method is equivalent to dropTree( tree, true );

Parameters:

tree - the new set of children

Throws:

SplitDropTreeException - If the tree is not acceptable.

dropTree

public void dropTree(SplitDockTree<Dockable> tree,
                     boolean checkValidity)

Removes all children from this station and then adds the contents that are stored in tree.

Parameters:

tree - the new set of children

checkValidity - whether to ensure that the new elements are accepted or not.

Throws:

SplitDropTreeException - if checkValidity is set to true and the tree is not acceptable

createTree

public DockableSplitDockTree createTree()

Gets the contents of this station as a SplitDockTree.

Returns:

the tree

createTree

public void createTree(SplitDockTreeFactory factory)

Writes the contents of this station into factory.

Parameters:

factory - the factory to write into

visit

public <N> N visit(SplitTreeFactory<N> factory)

Visits the internal structure of this station.

Type Parameters:

N - the type of result this method produces

Parameters:

factory - a factory that will collect information

Returns:

the result of factory

canDrag

public boolean canDrag(Dockable dockable)

Description copied from interface: DockStation

Tells whether dockable can be removed from this station or not. This method assumes that dockable is a child of this station, if not, then the behavior of this method is unspecified.
Note that the result of this method may not be respected every time, it's more a hint for the controller how to act.

Specified by:

canDrag in interface DockStation

Parameters:

dockable - a child of this station

Returns:

true if dockable can be dragged

drag

public void drag(Dockable dockable)

Description copied from interface: DockStation

Removes a child from this station. This method may be called even if DockStation.canDrag(Dockable) returned false.
Note: clients may need to invoke DockController.freezeLayout() and DockController.meltLayout() to ensure noone else adds or removes Dockables.

Specified by:

drag in interface DockStation

Parameters:

dockable - the child to remove

fireFullScreenChanged

protected void fireFullScreenChanged(Dockable oldDockable,
                                     Dockable newDockable)

Sends a message to all registered instances of SplitDockListener, that the Dockable in fullscreen-mode has changed.

Parameters:

oldDockable - the old fullscreen-Dockable, can be null

newDockable - the new fullscreen-Dockable, can be null

fireTitleExchanged

protected void fireTitleExchanged(DockTitle title)

Informs all DockableListeners that title is no longer considered to be a good title and should be exchanged.

Parameters:

title - a title, can be null

fireTitleExchanged

protected void fireTitleExchanged()

Informs all DockableListeners that all bound titles and the null title are no longer considered good titles and should be replaced

asDockable

public Dockable asDockable()

Description copied from interface: DockElement

Returns this if this is an instance of Dockable. Otherwise null is returned.

Specified by:

asDockable in interface DockElement

Specified by:

asDockable in interface PlaceholderListItem<Dockable>

Returns:

this or null. Must not return null if DockElement.asDockable() already returns null.

getPaint

public DefaultStationPaintValue getPaint()

Gets a StationPaint to paint markings on this station.

Returns:

the paint

getDisplayerFactory

public DefaultDisplayerFactoryValue getDisplayerFactory()

Gets a DisplayerFactory to create new DockableDisplayer for this station.

Returns:

the factory

getDisplayers

public DisplayerCollection getDisplayers()

Gets the set of displayers that are currently used by this station.

Returns:

the set of displayers

getCombiner

public StationCombinerValue getCombiner()

Gets a Combiner to combine Dockables on this station.

Returns:

the combiner

paintOverlay

protected void paintOverlay(Graphics g)

Description copied from class: OverpaintablePanel

Paints the overlay over all components.

Overrides:

paintOverlay in class OverpaintablePanel

Parameters:

g - the graphics to use

addDockable

public void addDockable(Dockable dockable)

Adds dockable to this station.

Parameters:

dockable - A Dockable which must not be a child of this station.

canReplace

public boolean canReplace(Dockable old,
                          Dockable next)

Description copied from interface: DockStation

Tells whether its possible to replace the child old with next where next is not a child of this station.

Specified by:

canReplace in interface DockStation

Parameters:

old - a child of this station

next - the replacement of next.

Returns:

true if the replacement is possible

replace

public void replace(DockStation old,
                    Dockable next)

Description copied from interface: DockStation

Replaces the child old by next which is not yet a child of this station. This method should not be called if canReplace returned false. This method can assume that next was a child of old but no longer is.

Specified by:

replace in interface DockStation

Parameters:

old - a dockable station that is a child of this station

next - the replacement of old

replace

public void replace(Dockable previous,
                    Dockable next)

Description copied from interface: DockStation

Replaces the child old by next which is not yet a child of this station. This method should not be called if canReplace returned false.

Specified by:

replace in interface DockStation

Parameters:

previous - a child

next - the replacement of old

discard

protected void discard(DockableDisplayer displayer)

Removes displayer and creates a replacement.

Parameters:

displayer - the displayer to replaces

indexOfDockable

public int indexOfDockable(Dockable dockable)

Gets the index of a child of this station.

Parameters:

dockable - the child which is searched

Returns:

the index or -1 if the child was not found

removeAllDockables

public void removeAllDockables()

Removes all children from this station.
Note: clients may need to invoke DockController.freezeLayout() and DockController.meltLayout() to ensure noone else adds or removes Dockables.

removeDockable

public void removeDockable(Dockable dockable)

Removes dockable from this station. If dockable is not a child of this station, nothing happens.
Note: clients may need to invoke DockController.freezeLayout() and DockController.meltLayout() to ensure noone else adds or removes Dockables.

Parameters:

dockable - the child to remove

removePlaceholder

public void removePlaceholder(Path placeholder)

Searches the entire tree for any occurence of placeholder and removes placeholder. Also shrinks the tree if some nodes or leafs are no longer required due to the removed placeholder

Parameters:

placeholder - the placeholder to remove

removePlaceholders

public void removePlaceholders(Set<Path> placeholders)

Searches the entire tree for all occurences of all placeholders in placeholders. All placeholders are removed and the tree shrinks where possible.

Parameters:

placeholders - the placeholders to remove

getRoot

public Root getRoot()

Gets the Root of the tree which stores all locations and sizes of the children of this station. Clients can modify the contents of this station directly by accessing this tree.
Note

• that removing or adding children to the tree does not automatically remove or add new Dockables, that has to be explicitly done through Leaf.setDockable(Dockable, bibliothek.gui.dock.DockHierarchyLock.Token).
• The tree should never be invalid. That means that each Node should have two children, and each Leaf should have a Dockable.

Returns:

the root

See Also:

root()

getNode

public SplitNode getNode(long id)

Searches the node whose id equals id.

Parameters:

id - the id to search

Returns:

the node with the id id

getFactoryID

public String getFactoryID()

Description copied from interface: DockElement

Gets the unique name of the DockFactory which can read and write elements of this type.

Specified by:

getFactoryID in interface DockElement

Returns:

the id of the factory

updateBounds

public void updateBounds()

Updates all locations and sizes of the Components which are in the structure of this tree.

getAccess

protected SplitDockStation.Access getAccess()

Allows subclasses access to the internal working of this SplitDockStation. Subclasses should be very careful when invoking methods of SplitDockStation.Access.

Returns:

the internal API of this station