bibliothek.gui.dock.control.focus
Interface FocusStrategy

All Known Implementing Classes:

DefaultFocusStrategy

public interface FocusStrategy

A FocusStrategy is used by a DockController to decide which Component to focus if a Dockable should receive the focus.

Author:

Benjamin Sigg

Method Summary

void	bind() Informs this strategy that it will be used from now on.
java.awt.Component	getFocusComponent(Dockable dockable, java.awt.Component mouseClicked) Given a Dockable this method tells which Component should be focused.
void	unbind() Informs this strategy that it is no longer used from now on.

Method Detail

bind

void bind()

Informs this strategy that it will be used from now on.

unbind

void unbind()

Informs this strategy that it is no longer used from now on.

getFocusComponent

java.awt.Component getFocusComponent(Dockable dockable,
                                     java.awt.Component mouseClicked)

Given a Dockable this method tells which Component should be focused.

Parameters:

dockable - some dockable which is about to get the focus

mouseClicked - the component which was touched by the mouse and which would get the focus normally. Can be null.

Returns:

the component to focus or null.

• null indicates that this strategy cannot decide what to do. In this case a default component will receive the focus.
• mouseClicked forces focus onto mouseClicked, even if that Component is not focusable.
• any other Component will receive focus if focusable, or focus will be transfered to the next focusable Component starting the search at the returned value.