ccl.swing
Class MainJFrame

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Frame
                          |
                          +--javax.swing.JFrame
                                |
                                +--ccl.swing.ExitJFrame
                                      |
                                      +--ccl.swing.MainJFrame
All Implemented Interfaces:
javax.accessibility.Accessible, java.awt.event.ActionListener, javax.swing.event.ChangeListener, java.util.EventListener, Exitable, java.awt.image.ImageObserver, java.awt.MenuContainer, javax.swing.RootPaneContainer, java.lang.Runnable, java.io.Serializable, javax.swing.WindowConstants, java.awt.event.WindowListener

public class MainJFrame
extends ExitJFrame
implements java.lang.Runnable, java.awt.event.ActionListener, javax.swing.event.ChangeListener

MainJFrame can be used to inherit you applications main frame class from, which would act as a controller and view of your application.

See Also:
Serialized Form

Inner Class Summary
static class MainJFrame.CCLMetalTheme
          A class representing a swing theme used by default for the ccl library.
 
Inner classes inherited from class javax.swing.JFrame
javax.swing.JFrame.AccessibleJFrame
 
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
 
Field Summary
static java.lang.String S_DOC_DIR
          Directory used by default for documentation.
 
Fields inherited from class javax.swing.JFrame
accessibleContext, EXIT_ON_CLOSE, rootPane, rootPaneCheckingEnabled
 
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 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
MainJFrame()
           
MainJFrame(java.lang.String sTitle_)
           
MainJFrame(java.lang.String[] asArg_, java.lang.String sRcsHeader_)
           
MainJFrame(java.lang.String sTitle_, java.lang.String[] asArg_, java.lang.String sRcsHeader_)
           
MainJFrame(java.lang.String sTitle_, java.lang.String[] asArg_, java.lang.String sRcsHeader_, java.lang.String sIniFile_)
           
 
Method Summary
protected  void _backup(java.lang.String sFileName_)
           
protected  boolean _confirmClose()
           
protected  java.lang.String _getProjectSuffix()
          You can overwrite this method to return a default project file suffix even if the ini file is missing.
protected  boolean _isQuitGuardOK()
          Deprecated. #_confirmClose
 void actionPerformed(java.awt.event.ActionEvent pActionEvent_)
           
 Init getInit()
           
 void initialize(java.lang.String[] asArg_, java.lang.String sInfoHeader_)
           
 void initialize(java.lang.String sTitle_, java.lang.String[] asArg_, java.lang.String sRcsHeader_)
           
 void initialize(java.lang.String sTitle_, java.lang.String[] asArg_, java.lang.String sRcsHeader_, java.lang.String sIniFileContent_)
           
 void interrupt()
           
protected  boolean isExitSet()
           
 boolean isModified()
           
 void newFile()
           
 void open()
          Interactively open new file/project.
 void open(java.lang.String sProjectFileName_)
          If you overwrite this method, it should invoke super.open( filename ) at the end.
 void openOldProject(java.lang.String sOldProjectName_)
           
 void run()
           
 void runAction(RunnableAction pRunnableAction_)
           
protected  void runHook()
           
 void save()
           
 void save(java.lang.String sFileName_)
          This is the method the user must implement.
 void saveAs()
           
 void setBackground(java.awt.Color pColor_)
           
 void setExit()
           
 void setMenuBar(java.util.Vector vMenus_)
           
 void setModified(boolean bModified_)
           
 void setTitle()
           
 void start()
           
 void stateChanged(javax.swing.event.ChangeEvent pChangeEvent_)
           
 void stop()
           
 void updateMenu()
           
 void windowClosing(java.awt.event.WindowEvent event)
           
 
Methods inherited from class ccl.swing.ExitJFrame
exit, windowActivated, windowClosed, windowDeactivated, windowDeiconified, windowIconified, windowOpened
 
Methods inherited from class javax.swing.JFrame
addImpl, createRootPane, frameInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getJMenuBar, getLayeredPane, getRootPane, isRootPaneCheckingEnabled, paramString, processKeyEvent, processWindowEvent, remove, setContentPane, setDefaultCloseOperation, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, update
 
Methods inherited from class java.awt.Frame
addNotify, finalize, getCursorType, getFrames, getIconImage, getMenuBar, getState, getTitle, isResizable, 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, 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, removeAll, removeContainerListener, setFont, 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, processMouseEvent, processMouseMotionEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBounds, setBounds, setComponentOrientation, setDropTarget, setEnabled, setForeground, setLocale, setLocation, 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
 

Field Detail

S_DOC_DIR

public static final java.lang.String S_DOC_DIR
Directory used by default for documentation. Ccl lib uses 'doc' for this, thought more and more projects seem to choose 'docs' instead.
Constructor Detail

MainJFrame

public MainJFrame()

MainJFrame

public MainJFrame(java.lang.String sTitle_)

MainJFrame

public MainJFrame(java.lang.String[] asArg_,
                  java.lang.String sRcsHeader_)

MainJFrame

public MainJFrame(java.lang.String sTitle_,
                  java.lang.String[] asArg_,
                  java.lang.String sRcsHeader_)

MainJFrame

public MainJFrame(java.lang.String sTitle_,
                  java.lang.String[] asArg_,
                  java.lang.String sRcsHeader_,
                  java.lang.String sIniFile_)
Method Detail

initialize

public void initialize(java.lang.String[] asArg_,
                       java.lang.String sInfoHeader_)

initialize

public void initialize(java.lang.String sTitle_,
                       java.lang.String[] asArg_,
                       java.lang.String sRcsHeader_)

initialize

public void initialize(java.lang.String sTitle_,
                       java.lang.String[] asArg_,
                       java.lang.String sRcsHeader_,
                       java.lang.String sIniFileContent_)

setMenuBar

public void setMenuBar(java.util.Vector vMenus_)

updateMenu

public void updateMenu()

runAction

public void runAction(RunnableAction pRunnableAction_)

runHook

protected void runHook()

getInit

public Init getInit()

run

public void run()
Specified by:
run in interface java.lang.Runnable

start

public void start()

stop

public void stop()

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent pActionEvent_)
Specified by:
actionPerformed in interface java.awt.event.ActionListener

setExit

public void setExit()
Overrides:
setExit in class ExitJFrame

isExitSet

protected boolean isExitSet()

windowClosing

public void windowClosing(java.awt.event.WindowEvent event)
Overrides:
windowClosing in class ExitJFrame

setBackground

public void setBackground(java.awt.Color pColor_)
Overrides:
setBackground in class java.awt.Component

interrupt

public void interrupt()

setModified

public void setModified(boolean bModified_)

newFile

public void newFile()

open

public void open()
Interactively open new file/project.

open

public void open(java.lang.String sProjectFileName_)
If you overwrite this method, it should invoke super.open( filename ) at the end.

openOldProject

public void openOldProject(java.lang.String sOldProjectName_)

_backup

protected void _backup(java.lang.String sFileName_)

save

public void save()

_getProjectSuffix

protected java.lang.String _getProjectSuffix()
You can overwrite this method to return a default project file suffix even if the ini file is missing.

saveAs

public void saveAs()

save

public void save(java.lang.String sFileName_)
This is the method the user must implement. User has not to take care of setting saved flag etc.

_confirmClose

protected boolean _confirmClose()

_isQuitGuardOK

protected boolean _isQuitGuardOK()
Deprecated. #_confirmClose


stateChanged

public void stateChanged(javax.swing.event.ChangeEvent pChangeEvent_)
Specified by:
stateChanged in interface javax.swing.event.ChangeListener

setTitle

public void setTitle()

isModified

public boolean isModified()