com.glaivestone.mv.swing
Class JFrameApplicationView

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Frame
                          |
                          +--javax.swing.JFrame
                                |
                                +--com.glaivestone.mv.swing.JFrameApplicationView

All Implemented Interfaces:

javax.accessibility.Accessible, ApplicationView, java.awt.image.ImageObserver, java.awt.MenuContainer, javax.swing.RootPaneContainer, java.io.Serializable, javax.swing.WindowConstants

Direct Known Subclasses:

SimpleTextWindowView

public class JFrameApplicationView

extends javax.swing.JFrame

implements ApplicationView

A Swing main window frame which implements a view on an application model.

Subclass Responsibilities

Subclasses are responsible for creating the view components for the window contents (child components of the top-level container). Child components are usually constructed either at creation time or when the application model is installed in the view.

When the application model is installed in the view, the following methods are invoked to initialize the view:

• initializeMainWindow
• initializeWindow - initialize the contents (child components) of the main window

Subclass implementations of the two initialization methods are responsible for constructing the contents of the view (if not already done), initializing the state of the view elements to present the state of the application, and configuring dependencies on notifications from the application data models and the view items to enable user interaction and view updating for the application presented in this view.

Subclasses should reimplement the configureWindowTitle and configureWindowIcon methods if the application name and icon are controlled by the application rather than by a hardwired definition in the view itself. These methods are used by the standard initializeMainWindow; they do nothing unless overridden.

Author:

Deb Lewis

See Also:

Serialized Form

Field Summary

Fields inherited from class javax.swing.JFrame

EXIT_ON_CLOSE

Fields inherited from class java.awt.Frame

CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, HIDE_ON_CLOSE

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

JFrameApplicationView()
Constructs a new frame window that is initially invisible.

JFrameApplicationView(java.lang.String title)
Constructs a new frame window with the specified title that is initially invisible.

Method Summary

void	closeWindow() Close this view.
void	configureAppNameWindowTitle() Configure the window title with the standard representation of the application name and (optionally) the application subject description.
ApplicationModel	getAppModel() Answer the application model which this view presents.
java.awt.Window	getMainWindow() Answer the window which implements this view.
boolean	requestCloseWindow() Request that this view be closed.
void	setAppModel(ApplicationModel aModel) Specify the application model which this view presents.

Methods inherited from class javax.swing.JFrame

getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getJMenuBar, getLayeredPane, getRootPane, isDefaultLookAndFeelDecorated, remove, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, update

Methods inherited from class java.awt.Frame

addNotify, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setCursor, setExtendedState, setIconImage, setMaximizedBounds, setMenuBar, setResizable, setState, setTitle, setUndecorated

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, hide, isActive, isFocusableWindow, isFocusCycleRoot, isFocused, isShowing, pack, postEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationRelativeTo, show, toBack, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, remove, removeAll, removeContainerListener, setFocusTraversalKeys, setFocusTraversalPolicy, setFont, transferFocusBackward, transferFocusDownCycle, validate

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, dispatchEvent, enable, enable, enableInputMethods, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isOpaque, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Constructor Detail

JFrameApplicationView

public JFrameApplicationView()

Constructs a new frame window that is initially invisible.

See Also:

The JFrame constructor

JFrameApplicationView

public JFrameApplicationView(java.lang.String title)

Constructs a new frame window with the specified title that is initially invisible.

See Also:

The JFrame constructor

Method Detail

closeWindow

public void closeWindow()

Close this view.

Specified by:

closeWindow in interface ApplicationView

See Also:

ApplicationView.closeWindow(), ApplicationView.requestCloseWindow()

configureAppNameWindowTitle

public void configureAppNameWindowTitle()

Configure the window title with the standard representation of the application name and (optionally) the application subject description.

Intended for use in subclass implementations of configureWindowTitle

getAppModel

public ApplicationModel getAppModel()

Answer the application model which this view presents.

Specified by:

getAppModel in interface ApplicationView

See Also:

ApplicationView.getAppModel()

getMainWindow

public java.awt.Window getMainWindow()

Answer the window which implements this view.

Specified by:

getMainWindow in interface ApplicationView

See Also:

ApplicationView.getMainWindow()

requestCloseWindow

public boolean requestCloseWindow()

Request that this view be closed. Answer whether the close operation completed.

Specified by:

requestCloseWindow in interface ApplicationView

See Also:

ApplicationView.requestCloseWindow(), ApplicationView.closeWindow()

setAppModel

public void setAppModel(ApplicationModel aModel)

Specify the application model which this view presents.

Specified by:

setAppModel in interface ApplicationView

See Also:

ApplicationView.setAppModel(com.glaivestone.mv.ApplicationModel)