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 to hold an applet (of applications) or a 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 class acts as a top-level window which is usually used to contain applet when JavaView runs as a standalone application.

It common practice that another class registers itself as window listener.

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 registers itself as window listener of each frame.

See Also:

Serialized Form

Field Summary

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 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)
Constructor, calls PsMainFrame(null, title, null).

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.
void	setInnerBounds(int x, int y, int width, int height) Set the size of the drawing canvas (instead of the size of the frame including insets).
void	setInnerBounds(java.awt.Rectangle rect) Set the size of the drawing canvas (instead of the size of the frame including insets).
void	setInnerSize(java.awt.Dimension dim) Set the size of the drawing canvas (instead of the size of the frame including insets).
void	setInnerSize(int width, int height) Set the size of the drawing canvas (instead of the size of the frame including insets).
void	setLocation(int x, int y) Set location of dialog but correct upper left corner if outside screen.
void	windowActivated(java.awt.event.WindowEvent event) Currently not used.
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) Currently not used.
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, getAccessibleContext, 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, remove, removeAll, removeContainerListener, setFocusTraversalKeys, setFocusTraversalPolicy, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, 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, 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

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)

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

Since:

JavaView 2.47

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 is 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

setInnerBounds

public void setInnerBounds(java.awt.Rectangle rect)

Set the size of the drawing canvas (instead of the size of the frame including insets). This method calls the method java.awt.frame#setBounds which sets the size of the frame including boundary and title bar.

Since:

JavaView 2.46

setInnerBounds

public void setInnerBounds(int x,
                           int y,
                           int width,
                           int height)

Set the size of the drawing canvas (instead of the size of the frame including insets). This method calls the method java.awt.frame#setBounds which sets the size of the frame including boundary and title bar.

Since:

JavaView 2.46

setInnerSize

public void setInnerSize(int width,
                         int height)

Set the size of the drawing canvas (instead of the size of the frame including insets). This method calls the method java.awt.frame#setSize which sets the size of the frame including boundary and title bar.

Since:

JavaView 2.46

setInnerSize

public void setInnerSize(java.awt.Dimension dim)

Set the size of the drawing canvas (instead of the size of the frame including insets). This method calls the method java.awt.frame#setSize which sets the size of the frame including boundary and title bar.

Since:

JavaView 2.46

setLocation

public void setLocation(int x,
                        int y)

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

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)

Currently not used.

Specified by:

windowDeactivated in interface java.awt.event.WindowListener

windowActivated

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

Currently not used.

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