oracle.ide.docking
Class DockStation

java.lang.Object
  oracle.ide.docking.DockStation

All Implemented Interfaces:

Addin, Controller

public abstract class DockStation
extends java.lang.Object
implements Controller, Addin

The singleton for docking operations. To write a dockable window, you must create your own DockableWindows and a DockableFactory.

See Docking Package Summary

Field Summary

static int	STATUS_ACCESSIBLE The user has a direct access to the dockable.
static int	STATUS_ACTIVE Dockable is active (title bar is dark blue)
static int	STATUS_MINIMIZED
static int	STATUS_PINNED
static int	STATUS_PRESENT
static int	STATUS_VISIBLE Dockable is visible.

Fields inherited from interface oracle.ide.controller.Controller

UPDATE_FROM_ACTION_PERFORMED, UPDATE_FROM_ACTIVE_VIEW_CHANGED, UPDATE_FROM_UNDO, UPDATE_FROM_USER_EXTENSION, UPDATE_FROM_VIEW_SELECTION_CHANGED

Constructor Summary

DockStation()

Method Summary

abstract boolean	activateAnyDockable() Sets the focus in the first available dockable window.
abstract boolean	activateDockable(Dockable dockable) Sets the focus in the specified dockable.
abstract void	addDockableListener(DockableListener l, Dockable d) Dockable listeners are manipulated by the DockStation to simplify the implementation of the Dockable interface.
protected abstract void	addToCache(Dockable dockable)
abstract void	close(Dockable dockable) Close the specified dockable.
abstract DockableDragContext	createDockableDragContext(DockableDragSource dockableDragSource)
protected abstract DrawerModel	createDrawerModel(DrawerDockableWindow drawerDockableWindow)
abstract void	dock(Dockable dockable, DockingParam dockingParam) Inserts the dockable into the docking system.
abstract Dockable	findDockable(ViewId viewId) Searches/create a dockable based on a name.
abstract void	fireDockableEvent(DockableEvent e)
abstract Dockable	getDockable(ViewId viewId) Searches a dockable based on a name.
abstract int	getDockableStatus(Dockable dockable)
static DockStation	getDockStation()
abstract void	initialize() This method is called to give this class an opportunity to hook layout listeners to the ide.
abstract void	install(javax.swing.JFrame frame, java.awt.Container topPanel, javax.swing.JComponent centerPanel) Initializes the docking system.
abstract boolean	isDockableVisible(Dockable dockable)
abstract boolean	isDockableVisible(java.lang.String viewId)
abstract DockableFactory	lookupFactory(ViewId viewId)
abstract void	registerDockableFactory(java.lang.String viewTypeId, DockableFactory factory) Deprecated. clients use a declarative "dockable-factory-hook" trigger hook in their extension.xml.
abstract void	registerDockableFactory(java.lang.String viewTypeId, DockableFactory factory, double priority) Deprecated. clients should use a declarative "dockable-factory-hook" trigger hook in their extension.xml.
abstract void	removeDockableListener(DockableListener l, Dockable d) Unregisters a dockable listener.
protected abstract void	removeFromCache(Dockable dockable)
protected abstract void	removeFromCache(java.lang.String uniqueName)
abstract void	saveLayout(PropertyAccess pa) Saves all of the docking layout.
abstract void	setDockableVisible(Dockable dockable, boolean bVisible)
abstract void	setDockableVisible(java.lang.String strViewId, boolean bVisible) Show/hide a dockable.
static void	setDockStation(DockStation dockStation) Publishes the specified DockStation as the active instance in the IDE.
abstract void	undock(Dockable dockable) Remove the dockable.
protected abstract void	undock(Dockable dockable, int flags)
abstract void	unregisterDockableFactory(java.lang.String viewTypeId)

Methods inherited from class java.lang.Object

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

Methods inherited from interface oracle.ide.controller.Controller

handleEvent, update

Field Detail

STATUS_PRESENT

public static final int STATUS_PRESENT

See Also:

Constant Field Values

STATUS_PINNED

public static final int STATUS_PINNED

See Also:

Constant Field Values

STATUS_MINIMIZED

public static final int STATUS_MINIMIZED

See Also:

Constant Field Values

STATUS_ACCESSIBLE

public static final int STATUS_ACCESSIBLE

The user has a direct access to the dockable. If the dockable is tabbed with other dockables and is not the selected page, it is still considered as accessible. If the dockable is unpinned and minized, it is also considered as accessible.

See Also:

Constant Field Values

STATUS_ACTIVE

public static final int STATUS_ACTIVE

Dockable is active (title bar is dark blue)

See Also:

Constant Field Values

STATUS_VISIBLE

public static final int STATUS_VISIBLE

Dockable is visible. If multiple dockables are tabbed together, only the selected page is considered to be visible.

See Also:

Constant Field Values

Constructor Detail

DockStation

public DockStation()

Method Detail

getDockStation

public static DockStation getDockStation()

Returns:

the DockStation instance that is active in the IDE.

setDockStation

public static void setDockStation(DockStation dockStation)

Publishes the specified DockStation as the active instance in the IDE.

Parameters:

dockStation - the specified dock station.

registerDockableFactory

@Deprecated
public abstract void registerDockableFactory(java.lang.String viewTypeId,
                                                        DockableFactory factory)

Deprecated. clients use a declarative "dockable-factory-hook" trigger hook in their extension.xml.

Register a factory that can create dockables. Dockable layouts can be saved. When they are loaded, a factory is needed to create and initialize the dockables.

Parameters:

viewTypeId - the type id of the factory.

factory - the dockable factory to register.

registerDockableFactory

@Deprecated
public abstract void registerDockableFactory(java.lang.String viewTypeId,
                                                        DockableFactory factory,
                                                        double priority)

Deprecated. clients should use a declarative "dockable-factory-hook" trigger hook in their extension.xml.

unregisterDockableFactory

public abstract void unregisterDockableFactory(java.lang.String viewTypeId)

lookupFactory

public abstract DockableFactory lookupFactory(ViewId viewId)

addDockableListener

public abstract void addDockableListener(DockableListener l,
                                         Dockable d)

Dockable listeners are manipulated by the DockStation to simplify the implementation of the Dockable interface.

Parameters:

l - the listener to add.

d - the dockable to watch. If this value is null, the listener will be registered for every dockable.

removeDockableListener

public abstract void removeDockableListener(DockableListener l,
                                            Dockable d)

Unregisters a dockable listener. Both the listener AND the dockable must match. If the listener was registered with a null dockable, a null dockable must be passed to the removeDockableListener.

Parameters:

l - the listener to remove.

d - the dockable on which the listener was registered.

initialize

public abstract void initialize()

This method is called to give this class an opportunity to hook layout listeners to the ide.

Specified by:

initialize in interface Addin

See Also:

AddinManager

install

public abstract void install(javax.swing.JFrame frame,
                             java.awt.Container topPanel,
                             javax.swing.JComponent centerPanel)

Initializes the docking system.

Parameters:

frame - The main application frame. It will be used to attach floating windows.

topPanel - usually the contentFrame.

centerPanel - the place where MDI windows will circulate.

isDockableVisible

public abstract boolean isDockableVisible(java.lang.String viewId)

Returns:

true if the view identified by the given viewId is visible.

isDockableVisible

public abstract boolean isDockableVisible(Dockable dockable)

Returns:

true if the given dockable is visible.

getDockableStatus

public abstract int getDockableStatus(Dockable dockable)

dock

public abstract void dock(Dockable dockable,
                          DockingParam dockingParam)

Inserts the dockable into the docking system.

Parameters:

dockable - the dockable to insert.

dockingParam - specifies where to place the dockable.

undock

public abstract void undock(Dockable dockable)

Remove the dockable. If the component is realized, it is removed from its TitledPanel.

Parameters:

dockable - the dockable to remove.

undock

protected abstract void undock(Dockable dockable,
                               int flags)

setDockableVisible

public abstract void setDockableVisible(java.lang.String strViewId,
                                        boolean bVisible)

Show/hide a dockable. If bVisible is true and the dockable was not created yet, the dockable factories will be searched and the one that matches the name will be asked to create the dockable. If bVisible is true and the container of the dockable is hidden (floating windows) the container will be shown too.

Parameters:

strViewId - the identification of the dockable.

bVisible - true if the dockable must be shown.

setDockableVisible

public abstract void setDockableVisible(Dockable dockable,
                                        boolean bVisible)

close

public abstract void close(Dockable dockable)

Close the specified dockable. Closing a dockable will generate a CLOSED state change notification. In addition, it will discard all discardable dockables.

Parameters:

dockable - the dockable to close.

saveLayout

public abstract void saveLayout(PropertyAccess pa)

Saves all of the docking layout.

Parameters:

pa - the storage object.

activateDockable

public abstract boolean activateDockable(Dockable dockable)

Sets the focus in the specified dockable.

Parameters:

dockable - the dockable to activate.

activateAnyDockable

public abstract boolean activateAnyDockable()

Sets the focus in the first available dockable window. This method is called when the last editor is closed.

getDockable

public abstract Dockable getDockable(ViewId viewId)

Searches a dockable based on a name.

Parameters:

viewId - the id or name used as search criteria.

Returns:

the found dockable or null if the dockable was not found.

findDockable

public abstract Dockable findDockable(ViewId viewId)

Searches/create a dockable based on a name.

createDockableDragContext

public abstract DockableDragContext createDockableDragContext(DockableDragSource dockableDragSource)

addToCache

protected abstract void addToCache(Dockable dockable)

removeFromCache

protected abstract void removeFromCache(Dockable dockable)

removeFromCache

protected abstract void removeFromCache(java.lang.String uniqueName)

createDrawerModel

protected abstract DrawerModel createDrawerModel(DrawerDockableWindow drawerDockableWindow)

fireDockableEvent

public abstract void fireDockableEvent(DockableEvent e)