bibliothek.gui.dock.security
Class SecureDockController

java.lang.Object
  extended by bibliothek.gui.DockController
      extended by bibliothek.gui.dock.security.SecureDockController

public class SecureDockController
extends DockController

The DockingFrames normally uses some system-resources to handle global events. However, there are some environments where system-resources are not available due to a SecurityManager (for example in an Applet). The Secure-X-classes are designed to work in such an environment. They are not as efficient as the normal classes, and there may be some settings where they have a weird behaviour.
Setting up the secure environment is easy: just use a SecureXZY where normally a XYZ would be. Additionally clients must pack all stations into one or more GlassedPanes. These panes must then be added to the SecureMouseFocusObserver of this SecureDockController.
Note that SecureFlapDockStation and SecureScreenDockStation will add a GlassedPane to their windows and dialogs automatically.

Author:
Benjamin Sigg

Constructor Summary
SecureDockController()
          Creates a new controller
SecureDockController(SecureDockControllerFactory factory)
          Creates a new controller, but does not initiate the properties if factory is null.
 
Method Summary
 SecureMouseFocusObserver getFocusObserver()
          Gets the current focus-controller
 SecureKeyboardController getKeyboardController()
          Gets the manager that handles all global KeyEvents.
protected  void initiate()
          To be called by subclasses if they use a null value when calling the constructor of this class.
static boolean isRequested()
          Deprecated. uses a proprietary implementation, currently no replacement available
 GlassedPane wrap(Component component)
          Wraps component into a GlassedPane and registers the GlassedPane.
 GlassedPane wrap(JComponent component)
          Wraps component into a GlassedPane and registers the GlassedPane.
 
Methods inherited from class bibliothek.gui.DockController
add, addAcceptance, addActionGuard, addActionOffer, addDockableFocusListener, addDockableSelectionListener, addDockTitleBindingListener, addRepresentative, addRepresentativeListener, addUIListener, dockableFocusListeners, dockableSelectionListeners, dockTitleBindingListeners, ensureFocusSet, findRootWindow, fireDockableFocused, fireDockableSelected, fireTitleBound, fireTitleUnbound, freezeLayout, getAcceptance, getActionOffer, getActionViewConverter, getColors, getComponentHierarchyObserver, getDefaultActionOffer, getDockableSelector, getDockTitleManager, getDoubleClickController, getExtensions, getFocusedDockable, getFonts, getIcons, getPopupSuppressor, getProperties, getRegister, getRelocator, getRootWindowProvider, getSingleParentRemover, getStation, getStationCount, getTheme, initiate, isBound, isFocused, isLayoutFrozen, isOnFocusing, kill, listOffers, meltLayout, remove, removeAcceptance, removeActionGuard, removeActionOffer, removeDockableFocusListener, removeDockableSelectionListener, removeDockTitleBindingListener, removeRepresentative, removeRepresentativeListener, removeUIListener, rootWindowChanged, searchElement, setAtLeastFocusedDockable, setDefaultActionOffer, setFocusedDockable, setFocusedDockable, setPopupSuppressor, setRootWindow, setRootWindowProvider, setSingleParentRemover, setTheme, uiListeners, updateUI
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SecureDockController

public SecureDockController()
Creates a new controller


SecureDockController

public SecureDockController(SecureDockControllerFactory factory)
Creates a new controller, but does not initiate the properties if factory is null.

Parameters:
factory - the factory that will create the elements of this controller
See Also:
initiate()
Method Detail

isRequested

@Deprecated
public static boolean isRequested()
Deprecated. uses a proprietary implementation, currently no replacement available

Tells whether SecureDockController is preferred over a DockController or not. The result is determined by a call to the SecurityManager.

Returns:
true if a SecureDockController should be used.

initiate

protected void initiate()
To be called by subclasses if they use a null value when calling the constructor of this class.


getFocusObserver

public SecureMouseFocusObserver getFocusObserver()
Description copied from class: DockController
Gets the current focus-controller

Overrides:
getFocusObserver in class DockController
Returns:
the controller

getKeyboardController

public SecureKeyboardController getKeyboardController()
Description copied from class: DockController
Gets the manager that handles all global KeyEvents.

Overrides:
getKeyboardController in class DockController
Returns:
the handler

wrap

public GlassedPane wrap(Component component)
Wraps component into a GlassedPane and registers the GlassedPane.

Parameters:
component - the component to envelope
Returns:
the replacement of component

wrap

public GlassedPane wrap(JComponent component)
Wraps component into a GlassedPane and registers the GlassedPane.

Parameters:
component - the component to envelope
Returns:
the replacement of component