byucc.jhdl.apps.Viewers
Class ViewerInternalFrame

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JInternalFrame
                  byucc.jhdl.apps.Viewers.ViewerInternalFrame

All Implemented Interfaces:

javax.accessibility.Accessible, java.awt.event.ActionListener, java.util.EventListener, java.awt.image.ImageObserver, java.awt.MenuContainer, javax.swing.RootPaneContainer, java.io.Serializable, javax.swing.WindowConstants

Direct Known Subclasses:

cvtInternalFrame, MemoryViewerInternalFrame, SchematicViewerInternalFrame, WavesWireInternalFrame, WiresTableInternalFrame

public abstract class ViewerInternalFrame

extends javax.swing.JInternalFrame

implements java.awt.event.ActionListener

Provides constants and code common to various frame generator class in byucc.jhdl.apps.Viewers. Subclasses must implement the abstract methods found in this class, as well as the actionPerformed method of the ActionListener interface. In the constructor of the subclass, the buildAndShowFrame method should be called. Note that this class makes the JFrame do nothing on a window closing event. Instead, an ActionEvent with the action specified in ACTION_CLOSE is generated and sent to the actionPerformed method.

Author:

Anthony L. Slade

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class javax.swing.JInternalFrame

javax.swing.JInternalFrame.AccessibleJInternalFrame, javax.swing.JInternalFrame.JDesktopIcon

Nested classes inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

static java.lang.String	ACTION_CLOSE String used for the close action command
static java.lang.String	ACTION_EXIT String used for the exit action command
static boolean	DEFAULT_SHOW_CONFIRM_DIALOG_ON_CLOSE
static boolean	DEFAULT_SHOW_CONFIRM_DIALOG_ON_EXIT
static boolean	DEFAULT_SYSTEM_EXIT_WHEN_ALL_VIEWERFRAMES_CLOSED This constant is true
protected boolean	showConfirmDialogOnClose
protected boolean	showConfirmDialogOnExit
protected static boolean	systemExitWhenAllViewerInternalFramesClosed When true, a call to System.exit() will be made after the last ViewerInternalFrame is closed.

Fields inherited from class javax.swing.JInternalFrame

closable, CONTENT_PANE_PROPERTY, desktopIcon, FRAME_ICON_PROPERTY, frameIcon, GLASS_PANE_PROPERTY, iconable, IS_CLOSED_PROPERTY, IS_ICON_PROPERTY, IS_MAXIMUM_PROPERTY, IS_SELECTED_PROPERTY, isClosed, isIcon, isMaximum, isSelected, LAYERED_PANE_PROPERTY, maximizable, MENU_BAR_PROPERTY, resizable, ROOT_PANE_PROPERTY, rootPane, rootPaneCheckingEnabled, title, TITLE_PROPERTY

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

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, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

ViewerInternalFrame()

ViewerInternalFrame(java.lang.String title)

ViewerInternalFrame(java.lang.String title, boolean resizable, boolean closable, boolean maximizable, boolean iconifiable)

Method Summary

protected void	buildAndShowFrame() Calling this method will initialize the content panel by calling the buildContentPanel method, initialize the menu bar by calling buildMenuBar, and will setup other properties of the frame, especially window closing handling.
protected abstract java.awt.Container	buildContentPanel() Use this method to create the sole main panel for the frame.
protected abstract javax.swing.JMenuBar	buildMenuBar() Use this method to create the JMenuBar for the frame
void	dispose() This method overridden to call System.exit() when all of the ViewerInternalFrames are closed unless systemExitWhenAllViewerInternalFramesClosed is false.
boolean	setSystemExitOnAllViewerInternalFramesClosed(boolean b) Used to update the behavior after all ViewerInternalFrame have been closed

Methods inherited from class javax.swing.JInternalFrame

addImpl, addInternalFrameListener, createRootPane, doDefaultCloseAction, fireInternalFrameEvent, getAccessibleContext, getContentPane, getDefaultCloseOperation, getDesktopIcon, getDesktopPane, getFocusCycleRootAncestor, getFocusOwner, getFrameIcon, getGlassPane, getInternalFrameListeners, getJMenuBar, getLayer, getLayeredPane, getMenuBar, getMostRecentFocusOwner, getNormalBounds, getRootPane, getTitle, getUI, getUIClassID, getWarningString, hide, isClosable, isClosed, isFocusCycleRoot, isIcon, isIconifiable, isMaximizable, isMaximum, isResizable, isRootPaneCheckingEnabled, isSelected, moveToBack, moveToFront, pack, paintComponent, paramString, remove, removeInternalFrameListener, reshape, restoreSubcomponentFocus, setClosable, setClosed, setContentPane, setDefaultCloseOperation, setDesktopIcon, setFocusCycleRoot, setFrameIcon, setGlassPane, setIcon, setIconifiable, setJMenuBar, setLayer, setLayer, setLayeredPane, setLayout, setMaximizable, setMaximum, setMenuBar, setNormalBounds, setResizable, setRootPane, setRootPaneCheckingEnabled, setSelected, setTitle, setUI, show, toBack, toFront, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, removeAll, removeContainerListener, setFocusTraversalKeys, setFocusTraversalPolicy, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.awt.event.ActionListener

actionPerformed

Field Detail

ACTION_CLOSE

public static final java.lang.String ACTION_CLOSE

String used for the close action command

See Also:

Constant Field Values

ACTION_EXIT

public static final java.lang.String ACTION_EXIT

String used for the exit action command

See Also:

Constant Field Values

DEFAULT_SYSTEM_EXIT_WHEN_ALL_VIEWERFRAMES_CLOSED

public static final boolean DEFAULT_SYSTEM_EXIT_WHEN_ALL_VIEWERFRAMES_CLOSED

This constant is true

See Also:

Constant Field Values

systemExitWhenAllViewerInternalFramesClosed

protected static boolean systemExitWhenAllViewerInternalFramesClosed

When true, a call to System.exit() will be made after the last ViewerInternalFrame is closed.

DEFAULT_SHOW_CONFIRM_DIALOG_ON_EXIT

public static final boolean DEFAULT_SHOW_CONFIRM_DIALOG_ON_EXIT

See Also:

Constant Field Values

DEFAULT_SHOW_CONFIRM_DIALOG_ON_CLOSE

public static final boolean DEFAULT_SHOW_CONFIRM_DIALOG_ON_CLOSE

See Also:

Constant Field Values

showConfirmDialogOnExit

protected boolean showConfirmDialogOnExit

showConfirmDialogOnClose

protected boolean showConfirmDialogOnClose

Constructor Detail

ViewerInternalFrame

public ViewerInternalFrame()

ViewerInternalFrame

public ViewerInternalFrame(java.lang.String title)

ViewerInternalFrame

public ViewerInternalFrame(java.lang.String title,
                           boolean resizable,
                           boolean closable,
                           boolean maximizable,
                           boolean iconifiable)

Method Detail

setSystemExitOnAllViewerInternalFramesClosed

public boolean setSystemExitOnAllViewerInternalFramesClosed(boolean b)

Used to update the behavior after all ViewerInternalFrame have been closed

Parameters:

b - if true System.exit will be called when the last open ViewerInternalFrame is disposed, otherwise, nothing beyond closing will happen when closing the ViewerInternalFrame

Returns:

the previous setting for systemExitWhenAllViewerInternalFramesClosed

dispose

public void dispose()

This method overridden to call System.exit() when all of the ViewerInternalFrames are closed unless systemExitWhenAllViewerInternalFramesClosed is false.

buildContentPanel

protected abstract java.awt.Container buildContentPanel()

Use this method to create the sole main panel for the frame. This panel may be comprised of other subpanels.

Returns:

a Container to be used as the content panel for the frame.

buildMenuBar

protected abstract javax.swing.JMenuBar buildMenuBar()

Use this method to create the JMenuBar for the frame

Returns:

the JMenuBar for the frame.

buildAndShowFrame

protected void buildAndShowFrame()

Calling this method will initialize the content panel by calling the buildContentPanel method, initialize the menu bar by calling buildMenuBar, and will setup other properties of the frame, especially window closing handling. Then this method packs the frame and sets it visible.