jv.object
Class PsMainFrame

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Frame
                          |
                          +--jv.object.PsMainFrame

All Implemented Interfaces:

javax.accessibility.Accessible, java.util.EventListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.awt.event.WindowListener

public class PsMainFrame

extends java.awt.Frame

implements java.awt.event.WindowListener, java.io.Serializable

Mainframe window for applications to hold the applet or the display canvas.

This class is a simple extension to java.awt.Frame and closes itself if the user presses the close button in the upper right corner of the window. The standard frame class does not close when user presses the destroy icon in the upper right corner.

Class acts as a top-level window which is usually used to contain applet when JavaView runs as a standalone application. Each frame forwards all key events to the JavaView viewer manager. The viewer is obtained from current project through PjProject#getViewer().

When JavaView runs from command-line, command-line arguments may be passed to constructor, and are added to System properties. Properties are, e.g., evaluated in PvViewer. Class handles window events. If viewer is used in JavaView applet then viewer is registered as window and keyboard event listener of each frame.

Version:

07.08.99, 1.20 revised (kp) Conversion to AWT 1.1
04.08.99, 1.10 revised (kp) Deprecated constructors removed.

See Also:

PvViewer.getParameter(String), Serialized Form

Inner classes inherited from class java.awt.Frame

java.awt.Frame.AccessibleAWTFrame

Inner classes inherited from class java.awt.Window

java.awt.Window.AccessibleAWTWindow

Inner classes inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Inner classes inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent

Fields inherited from class java.awt.Frame

CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, 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 java.awt.image.ImageObserver

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

Constructor Summary

PsMainFrame(java.awt.Component comp, java.lang.String[] args)
Constructor with default title.

PsMainFrame(java.awt.Component comp, java.lang.String title, java.lang.String[] args)
Create a main frame window to hold the applet or a display canvas.

PsMainFrame(java.lang.String title, java.lang.String[] args)
Constructor, calls PsMainFrame(null, title, args).

Method Summary

static java.lang.String	getParameter(java.lang.String name) Return a parameter from the system properties list.
static void	parseArgs(java.lang.String[] args, java.util.Properties props) Turn command-line arguments into system parameters by adding to the system properties list.
protected void	processWindowEvent(java.awt.event.WindowEvent event) Catch window events to manage key event handling across frames uniformly with viewer.
void	setBounds(java.awt.Rectangle rect) Set bounds of drawing canvas.
void	setLocation(int x, int y) Set location of dialog but correct of upper left corner if outside screen.
void	windowActivated(java.awt.event.WindowEvent event) On window activation add viewer to list of key listeners of frame.
void	windowClosed(java.awt.event.WindowEvent event) Currently not used.
void	windowClosing(java.awt.event.WindowEvent event) Dispose frame.
void	windowDeactivated(java.awt.event.WindowEvent event) On window deactivation remove viewer from list of key listeners of frame.
void	windowDeiconified(java.awt.event.WindowEvent event) Currently not used.
void	windowIconified(java.awt.event.WindowEvent event) Currently not used.
void	windowOpened(java.awt.event.WindowEvent event) Currently not used.

Methods inherited from class java.awt.Frame

addNotify, finalize, getAccessibleContext, getCursorType, getFrames, getIconImage, getMenuBar, getState, getTitle, isResizable, paramString, remove, removeNotify, setCursor, setIconImage, setMenuBar, setResizable, setState, setTitle

Methods inherited from class java.awt.Window

addWindowListener, applyResourceBundle, applyResourceBundle, dispose, getFocusOwner, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getOwnedWindows, getOwner, getToolkit, getWarningString, hide, isShowing, pack, postEvent, processEvent, removeWindowListener, setCursor, show, toBack, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setFont, setLayout, update, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, isLightweight, isOpaque, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setComponentOrientation, setDropTarget, setEnabled, setForeground, setLocale, setLocation, setName, setSize, setSize, setVisible, show, size, toString, transferFocus

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Constructor Detail

PsMainFrame

public PsMainFrame(java.awt.Component comp,
                   java.lang.String title,
                   java.lang.String[] args)

Create a main frame window to hold the applet or a display canvas. Any of the arguments may be null.

This frame class acts as a top-level window in which the applet appears when it is run as a standalone application.

See Also:

PvViewer.getParameter(String)

PsMainFrame

public PsMainFrame(java.lang.String title,
                   java.lang.String[] args)

Constructor, calls PsMainFrame(null, title, args).

PsMainFrame

public PsMainFrame(java.awt.Component comp,
                   java.lang.String[] args)

Constructor with default title.

Method Detail

parseArgs

public static void parseArgs(java.lang.String[] args,
                             java.util.Properties props)

Turn command-line arguments into system parameters by adding to the system properties list. In general, an argument must have the form

property=value

and does not contains any blanks. Blanks are used to separate arguments.

One exception it the model parameter which consists only of the file name. The property 'model' is assumed implicitly although it may be specified. This shortcut is a convenience for simplifying the loading of geometry models from file. Therefore, the following two shell commands are equivalent:

javaview knots.mgs

and

javaview model=knots.mgs

.

getParameter

public static java.lang.String getParameter(java.lang.String name)

Return a parameter from the system properties list. Each JavaView parameter has been added to the system property hashtable. Name of parameter is not case-sensitive.

Parameters:

name - Name of parameter whose value is requested, not case-sensitive.

Returns:

value Value of parameter

processWindowEvent

protected void processWindowEvent(java.awt.event.WindowEvent event)

Catch window events to manage key event handling across frames uniformly with viewer.

Overrides:

processWindowEvent in class java.awt.Window

windowOpened

public void windowOpened(java.awt.event.WindowEvent event)

Currently not used.

Specified by:

windowOpened in interface java.awt.event.WindowListener

windowClosed

public void windowClosed(java.awt.event.WindowEvent event)

Currently not used.

Specified by:

windowClosed in interface java.awt.event.WindowListener

windowDeiconified

public void windowDeiconified(java.awt.event.WindowEvent event)

Currently not used.

Specified by:

windowDeiconified in interface java.awt.event.WindowListener

windowIconified

public void windowIconified(java.awt.event.WindowEvent event)

Currently not used.

Specified by:

windowIconified in interface java.awt.event.WindowListener

windowDeactivated

public void windowDeactivated(java.awt.event.WindowEvent event)

On window deactivation remove viewer from list of key listeners of frame.

Specified by:

windowDeactivated in interface java.awt.event.WindowListener

windowActivated

public void windowActivated(java.awt.event.WindowEvent event)

On window activation add viewer to list of key listeners of frame.

Specified by:

windowActivated in interface java.awt.event.WindowListener

windowClosing

public void windowClosing(java.awt.event.WindowEvent event)

Dispose frame.

Specified by:

windowClosing in interface java.awt.event.WindowListener

setBounds

public void setBounds(java.awt.Rectangle rect)

Set bounds of drawing canvas.

Overrides:

setBounds in class java.awt.Component

setLocation

public void setLocation(int x,
                        int y)

Set location of dialog but correct of upper left corner if outside screen.

Overrides:

setLocation in class java.awt.Component