bibliothek.gui.dock.security
Class SecureDockController

java.lang.Object
  bibliothek.gui.DockController
      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