org.jhotdraw.app

Class SDIApplication

java.lang.Object

org.jhotdraw.beans.AbstractBean

org.jhotdraw.app.AbstractApplication

org.jhotdraw.app.SDIApplication

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, Application

public class SDIApplication
extends AbstractApplication

SDIApplication handles the lifecycle of multiple Views using a Windows single document interface (SDI).

This user interface created by this application follows the guidelines given in the Windows User Experience Interaction Guidelines.

An application of this type can open multiple Views. Each view is shown in a separate JFrame.

Each JFrame contains a menu bar, toolbars and palette bars for the views.

The life cycle of the application is tied to the JFrames. Closing the last JFrame quits the application. SDIApplication handles the life cycle of a single document window being presented in a JFrame. The JFrame provides all the functionality needed to work with the document, such as a menu bar, tool bars and palette windows.

The life cycle of the application is tied to the JFrame. Closing the JFrame quits the application.

The menu bar of a JFrame has the following standard menus:

 File   Edit   View   Help

The file menu has the following standard menu items:

  Clear (ClearFileAction.ID})
  New (NewFileAction.ID})
  New Window (NewWindowAction.ID})
  Load... (LoadFileAction.ID})
  Open... (OpenFileAction.ID})
  Load Directory... (LoadDirectoryAction.ID})
  Open Directory... (OpenDirectoryAction.ID})
  Load Recent > "Filename" (LoadRecentFileAction.ID)
  Open Recent > "Filename" (OpenRecentFileAction.ID)
  -
  Save (SaveFileAction.ID)
  Save As... (SaveFileAsAction.ID)
  Export... (ExportFileAction.ID)
  Print... (PrintFileAction.ID)
  -
  Close (CloseFileAction.ID)
 

The edit menu has the following standard menu items:

  Undo (UndoAction.ID})
  Redo (RedoAction.ID})
  -
  Cut (CutAction.ID})
  Copy (CopyAction.ID})
  Paste (PasteAction.ID})
  Duplicate (DuplicateAction.ID})
  Delete... (DeleteAction.ID})
  -
  Select All (SelectAllAction.ID})
  Clear Selection (ClearSelectionAction.ID})
  -
  Find (AbstractFindAction.ID})
  -
  Preferences... (AbstractPreferencesAction.ID)
 

The view menu has the following standard menu items:

  "Toolbar" (ToggleVisibleAction)
 

The view menu has the following standard menu items:

  About (AboutAction.ID)
 

The menus provided by the ApplicationModel are inserted between the file menu and the window menu. In case the application model supplies a menu with the title "Help", it is inserted after the window menu.

See Also:

Serialized Form

Field Summary

Fields inherited from class org.jhotdraw.app.AbstractApplication

VIEW_COUNT_PROPERTY

Fields inherited from interface org.jhotdraw.app.Application

ACTIVE_VIEW_PROPERTY, RECENT_URIS_PROPERTY

Constructor Summary

Constructors

Constructor and Description
SDIApplication() Creates a new instance.

Method Summary

Modifier and Type	Method and Description
void	configure(java.lang.String[] args) Configures the application using the provided arguments array.
javax.swing.JMenu	createEditMenu(View view) Creates an edit menu for the specified view or for the entire application.
javax.swing.JMenu	createFileMenu(View view) Creates a file menu for the specified view or for the entire application.
javax.swing.JMenu	createHelpMenu(View p) Creates a help menu for the specified view of for the entire application.
javax.swing.JMenu	createViewMenu(View view) Creates the view menu.
javax.swing.JMenu	createWindowMenu(View view) Creates a window menu for the specified view or for the entire application.
void	dispose(View p) This is a convenience method for removing a view and disposing it.
java.awt.Component	getComponent() Returns the application component.
void	hide(View p) Hides a view.
void	init() Initializes the application.
boolean	isSharingToolsAmongViews() Returns true, if this application shares tools among multiple views.
void	launch(java.lang.String[] args) Launches the application.
void	remove(View p) Removes a view from this application and removes it from the users view.
void	show(View view) Shows a view.

Methods inherited from class org.jhotdraw.app.AbstractApplication

add, addPalette, addRecentURI, addWindow, clearRecentURIs, createContainer, createView, destroy, getActionMap, getActiveView, getCopyright, getExportChooser, getImportChooser, getModel, getName, getOpenChooser, getRecentURIs, getSaveChooser, getVersion, isEnabled, removePalette, removeWindow, setActionMap, setActiveView, setEnabled, setModel, start, stop, views

Methods inherited from class org.jhotdraw.beans.AbstractBean

addPropertyChangeListener, addPropertyChangeListener, clone, getPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.jhotdraw.app.Application

addPropertyChangeListener, removePropertyChangeListener

Constructor Detail

SDIApplication

public SDIApplication()

Creates a new instance.

Method Detail

launch

public void launch(java.lang.String[] args)

Description copied from class: AbstractApplication

Launches the application.

Specified by:

launch in interface Application

Overrides:

launch in class AbstractApplication

Parameters:

args - This implementation supports the command-line parameter "-open" which can be followed by one or more filenames or URI's.

init

public void init()

Description copied from interface: Application

Initializes the application. configure() should have been invoked before the application is inited. Alternatively an application can be configured using setter methods.

Specified by:

init in interface Application

Overrides:

init in class AbstractApplication

remove

public void remove(View p)

Description copied from interface: Application

Removes a view from this application and removes it from the users view. Fires a "documentCount" property change event. Invokes method setApplication(null) on the view object.

Specified by:

remove in interface Application

Overrides:

remove in class AbstractApplication

configure

public void configure(java.lang.String[] args)

Description copied from interface: Application

Configures the application using the provided arguments array.

Specified by:

configure in interface Application

Overrides:

configure in class AbstractApplication

show

public void show(View view)

Description copied from interface: Application

Shows a view.

hide

public void hide(View p)

Description copied from interface: Application

Hides a view.

dispose

public void dispose(View p)

Description copied from interface: Application

This is a convenience method for removing a view and disposing it.

Specified by:

dispose in interface Application

Overrides:

dispose in class AbstractApplication

createFileMenu

@Nullable
public javax.swing.JMenu createFileMenu(View view)

Description copied from interface: Application

Creates a file menu for the specified view or for the entire application.

Parameters:

view - A view or null.

Returns:

A JMenu or null, if the menu is empty.

createEditMenu

@Nullable
public javax.swing.JMenu createEditMenu(View view)

Description copied from interface: Application

Creates an edit menu for the specified view or for the entire application.

Parameters:

view - A view or null.

Returns:

A JMenu or null, if the menu is empty.

isSharingToolsAmongViews

public boolean isSharingToolsAmongViews()

Description copied from interface: Application

Returns true, if this application shares tools among multiple views.

getComponent

public java.awt.Component getComponent()

Description copied from interface: Application

Returns the application component. This may return null, if the application is not represented by a component of its own on the user interface.

createWindowMenu

@Nullable
public javax.swing.JMenu createWindowMenu(View view)

Description copied from interface: Application

Creates a window menu for the specified view or for the entire application.

Parameters:

view - A view or null.

Returns:

A JMenu or null, if the menu is empty.

createViewMenu

public javax.swing.JMenu createViewMenu(View view)

Creates the view menu.

Parameters:

view - The View

Returns:

A JMenu or null, if the menu doesn't have any items.

createHelpMenu

public javax.swing.JMenu createHelpMenu(View p)

Description copied from interface: Application

Creates a help menu for the specified view of for the entire application.

Parameters:

p - A view or null.

Returns:

A JMenu or null, if the menu is empty.