jmri.util.swing
Interface WindowInterface

All Known Implementing Classes:

JmriJFrameInterface, JmriJInternalFrameInterface, PanedInterface

public interface WindowInterface

Interface for an object that can arrange for a JmriPanel to be displayed.

Typically used by some component that wants to display a pane (e.g. in an independent JmriJFrame or as part of a paned interface) to do some more stuff. Rather than have the component build it's own window, etc it invokes one of these, so that the position and display of that component can controlled.

Any JmriAbstractAction that uses the show() method will have its dispose() invoked when the associated frame goes away. It should dispose() any cached panes at that time.

Since:

2.9.4

Author:

Bob Jacobsen Copyright 2010

Nested Class Summary

static class

WindowInterface.Hint Suggested location for subsequent panels

Method Summary

void	dispose()
boolean	multipleInstances() Should 2nd and subsequent requests for a panel (e.g. in an Action) create a new instance, or provide the 1st one for reuse?
void	show(JmriPanel child, JmriAbstractAction action) Show, in whatever way is appropriate, a specific JmriPanel
void	show(JmriPanel child, JmriAbstractAction action, WindowInterface.Hint hint) Show, in whatever way is appropriate, a specific JmriPanel

Method Detail

show

void show(JmriPanel child,
          JmriAbstractAction action)

Show, in whatever way is appropriate, a specific JmriPanel

Parameters:

child - new JmriPanel to show

action - JmriAbstractAction making the request

show

void show(JmriPanel child,
          JmriAbstractAction action,
          WindowInterface.Hint hint)

Show, in whatever way is appropriate, a specific JmriPanel

Parameters:

child - new JmriPanel to show

action - JmriAbstractAction making the request

hint - suggestion on where to put the content

multipleInstances

boolean multipleInstances()

Should 2nd and subsequent requests for a panel (e.g. in an Action) create a new instance, or provide the 1st one for reuse? This would be true e.g. if separate windows were being provided, or false if there was only one window which is being populated with one pane after another.

Returns:

true if multiple instances should be provided, false if only one should be provided.

dispose

void dispose()