Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference
11g Release 1 (11.1.1.7.0)

E13403-08

oracle.ide.docking
Class DockStation

java.lang.Object
  extended by 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)
          Register a factory that can create dockables.
abstract  void registerDockableFactory(java.lang.String viewTypeId, DockableFactory factory, double priority)
           
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

public abstract void registerDockableFactory(java.lang.String viewTypeId,
                                             DockableFactory factory)
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

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

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)

Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference
11g Release 1 (11.1.1.7.0)

E13403-08

Copyright © 1997, 2013, Oracle. All rights reserved.