org.gicentre.treemappa.gui

Class JWFrame

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Frame

javax.swing.JFrame

org.gicentre.treemappa.gui.JWFrame

All Implemented Interfaces:

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

Direct Known Subclasses:

TreeFrame

public class JWFrame
extends javax.swing.JFrame
implements java.lang.Runnable

Creates a containing window with status, progress, menu and toolbar options. If this window contains any buttons on its toolbar, it must contain equivalent menu items. Menu items need not have equivalent toolbar buttons.

Menus are aligned with space for iconic representation. If icons are used they should be all the same size (16x16 recommended). Alignment is forced by inserting blank icons of the same size where necessary. This icon should be located at images/blank.gif in the classpath of the VM that uses this class.

Version:

3.3.0, 18th April, 2016.

Author:

Jo Wood, giCentre.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JFrame

javax.swing.JFrame.AccessibleJFrame

Nested classes/interfaces inherited from class java.awt.Frame

java.awt.Frame.AccessibleAWTFrame

Nested classes/interfaces inherited from class java.awt.Window

java.awt.Window.AccessibleAWTWindow, java.awt.Window.Type

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

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

Field Summary

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, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, 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

Constructors

Constructor and Description
JWFrame(java.lang.String title) Creates a top-level window with a given title.
JWFrame(java.lang.String title, java.lang.String iconName, boolean showMenu, boolean showTools, boolean showStatus) Creates a top-level window with various decoration options.

Method Summary

Modifier and Type	Method and Description
javax.swing.JMenuItem	addActionItem(int type, javax.swing.JMenuItem menu, java.lang.String name, java.lang.String icon, int mnemonic, int accelerator, java.awt.event.ActionListener listener) Adds a given menu and button item.
javax.swing.JMenuItem	addActionItem(int type, javax.swing.JMenuItem menu, java.lang.String name, java.lang.String iconName, int mnemonic, int accelerator, javax.swing.ButtonGroup bg, java.awt.event.ActionListener listener) Adds a given menu and button item.
javax.swing.JMenuItem	addActionItem(javax.swing.JMenuItem menu, java.lang.String name, int mnemonic, java.awt.event.ActionListener listener) Adds a given menu item to a given menu.
javax.swing.JMenuItem	addActionItem(javax.swing.JMenuItem menu, java.lang.String name, java.lang.String icon, int mnemonic, java.awt.event.ActionListener listener) Adds given menu and button items.
javax.swing.JMenuItem	addActionItem(javax.swing.JMenuItem menu, java.lang.String name, java.lang.String icon, int mnemonic, int accelerator, java.awt.event.ActionListener listener) Adds a given menu and button item.
javax.swing.JMenuItem	addBinActionItem(javax.swing.JMenuItem menu, java.lang.String name, boolean isSelected, int mnemonic, java.awt.event.ActionListener listener) Adds a given checkbox menu item to a given menu.
javax.swing.JMenuItem	addBinActionItem(javax.swing.JMenuItem menu, java.lang.String name, boolean isSelected, int mnemonic, javax.swing.ButtonGroup bg, java.awt.event.ActionListener listener) Adds given checkbox menu and toggle button items.
javax.swing.JMenuItem	addBinActionItem(javax.swing.JMenuItem menu, java.lang.String name, boolean isSelected, java.lang.String icon, int mnemonic, java.awt.event.ActionListener listener) Adds given checkbox menu and toggle button items.
javax.swing.JMenuItem	addBinActionItem(javax.swing.JMenuItem menu, java.lang.String name, boolean isSelected, java.lang.String icon, int mnemonic, javax.swing.ButtonGroup bg, java.awt.event.ActionListener listener) Adds given checkbox menu and toggle button items.
javax.swing.JMenuItem	addBinActionItem(javax.swing.JMenuItem menu, java.lang.String name, boolean isSelected, java.lang.String icon, int mnemonic, int accelerator, javax.swing.ButtonGroup bg, java.awt.event.ActionListener listener) Adds given checkbox menu and toggle button items.
javax.swing.JMenuItem	addBinActionItem(javax.swing.JMenuItem menu, java.lang.String name, int mnemonic, java.awt.event.ActionListener listener) Adds a given checkbox menu item to a given menu.
javax.swing.JMenuItem	addBinActionItem(javax.swing.JMenuItem menu, java.lang.String name, int mnemonic, javax.swing.ButtonGroup bg, java.awt.event.ActionListener listener) Adds a given checkbox menu item to a given menu.
javax.swing.JMenuItem	addBinActionItem(javax.swing.JMenuItem menu, java.lang.String name, int mnemonic, int accelerator, java.awt.event.ActionListener listener) Adds given checkbox menu and toggle button items.
javax.swing.JMenuItem	addBinActionItem(javax.swing.JMenuItem menu, java.lang.String name, java.lang.String icon, int mnemonic, java.awt.event.ActionListener listener) Adds given checkbox menu and toggle button items.
javax.swing.JMenuItem	addBinActionItem(javax.swing.JMenuItem menu, java.lang.String name, java.lang.String icon, int mnemonic, javax.swing.ButtonGroup bg, java.awt.event.ActionListener listener) Adds given checkbox menu and toggle button items.
void	addButtonSeparator() Adds a separator to the tool bar.
void	addInterruptionListener(JWInterruptionListener interruptionListener) Adds the given interruption listener to this window.
javax.swing.JMenu	addMenu(javax.swing.JComponent parent, java.lang.String name, int mnemonic) Adds a given menu with mnemonic to a component such as a menu bar or sub menu.
javax.swing.JMenu	addMenu(java.lang.String name) Adds a given menu without mnemonic to menu bar.
javax.swing.JMenu	addMenu(java.lang.String name, int mnemonic) Adds a given menu with mnemonic to menu bar.
static void	addMenuSeparator(javax.swing.JMenu menu) Adds a separator to the given menu.
protected void	closeDown() Asks the user if they really want to quit, then closes.
javax.swing.Action	getAction(java.lang.String name) Returns the action item (button or menu item) associated with the given name.
protected void	initWindow() Performs any window initialisation that is required after the frame has been displayed.
boolean	removeInterruptionListener(JWInterruptionListener interruptionListener) Removes the given interruption listener from this window.
void	run() Displays the frame as part of a threaded process.
void	setMaxProgress(int maxProgress) Displays the maximum progress value.
void	setMessage(java.lang.String text) Displays the given message in the status bar.
void	setMinProgress(int minProgress) Displays the minimum progress value.
void	setProgress(int progress) Sets the current progress (should be between 0 and 100 unless minimum or maximum progress values have been changed.
void	showProgress(boolean visible) Shows or removes the progress bar from the frame.

Methods inherited from class javax.swing.JFrame

addImpl, createRootPane, frameInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setIconImage, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update

Methods inherited from class java.awt.Frame

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

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, setVisible, 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, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, 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, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, 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, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, 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, processMouseWheelEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Constructor Detail

JWFrame

public JWFrame(java.lang.String title)

Creates a top-level window with a given title. Assumes that an icon file called Icon16.gif is located in he 'images' subdirectory.

Parameters:

title - Title of window.

JWFrame

public JWFrame(java.lang.String title,
               java.lang.String iconName,
               boolean showMenu,
               boolean showTools,
               boolean showStatus)

Creates a top-level window with various decoration options.

Parameters:

title - Title of window.

iconName - Name of file containing icon. File should be a .gif or .jpeg in the 'images' subdirectory.

showMenu - Menu will be displayed if true;

showTools - Toolbar will be displayed if true;

showStatus - Statusbar will be displayed if true;

Method Detail

addMenu

public javax.swing.JMenu addMenu(java.lang.String name)

Adds a given menu without mnemonic to menu bar.

Parameters:

name - Name on menu to add.

Returns:

Reference to the menu just created. This is useful for adding menu items.

addMenu

public javax.swing.JMenu addMenu(java.lang.String name,
                                 int mnemonic)

Adds a given menu with mnemonic to menu bar.

Parameters:

name - Name on menu to add.

mnemonic - Keyboard mnemonic to use.

Returns:

Reference to the menu just created. This is useful for adding menu items.

addMenu

public javax.swing.JMenu addMenu(javax.swing.JComponent parent,
                                 java.lang.String name,
                                 int mnemonic)

Adds a given menu with mnemonic to a component such as a menu bar or sub menu.

Parameters:

parent - Component onto which a menu is added.

name - Name on menu to add.

mnemonic - Keyboard mnemonic to use.

Returns:

Reference to the menu just created. This is useful for adding menu items.

addMenuSeparator

public static void addMenuSeparator(javax.swing.JMenu menu)

Adds a separator to the given menu. This should be called in sequence between adding other menus/menu items to the menu.

Parameters:

menu - Menu onto which a separator.

addButtonSeparator

public void addButtonSeparator()

Adds a separator to the tool bar. This should be called in sequence between adding other items to the toolbar.

addActionItem

public javax.swing.JMenuItem addActionItem(javax.swing.JMenuItem menu,
                                           java.lang.String name,
                                           int mnemonic,
                                           java.awt.event.ActionListener listener)

Adds a given menu item to a given menu.

Parameters:

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

mnemonic - Keyboard mnemonic to use.

listener - Action listener to respond to menu selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

addActionItem

public javax.swing.JMenuItem addActionItem(javax.swing.JMenuItem menu,
                                           java.lang.String name,
                                           java.lang.String icon,
                                           int mnemonic,
                                           java.awt.event.ActionListener listener)

Adds given menu and button items.

Parameters:

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

icon - Name of file containing icon or null if no icon.

mnemonic - Keyboard mnemonic to use.

listener - Action listener to respond to menu or button selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

addActionItem

public javax.swing.JMenuItem addActionItem(javax.swing.JMenuItem menu,
                                           java.lang.String name,
                                           java.lang.String icon,
                                           int mnemonic,
                                           int accelerator,
                                           java.awt.event.ActionListener listener)

Adds a given menu and button item.

Parameters:

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

icon - Name of file containing icon or null if no icon.

mnemonic - Keyboard mnemonic to use.

accelerator - Keyboard accelerator to use. Uses the system-dependent mask (e.g. CTRL on windows, Command on MacOS).

listener - Action listener to respond to menu or button selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

addActionItem

public javax.swing.JMenuItem addActionItem(int type,
                                           javax.swing.JMenuItem menu,
                                           java.lang.String name,
                                           java.lang.String icon,
                                           int mnemonic,
                                           int accelerator,
                                           java.awt.event.ActionListener listener)

Adds a given menu and button item.

Parameters:

type - Type of menu (NORMAL, CHECKBOX).

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

icon - Name of file containing icon or null if no icon.

mnemonic - Keyboard mnemonic to use.

accelerator - Keyboard accelerator to use. Uses the system-dependent mask (e.g. CTRL on windows, Command on MacOS).

listener - Action listener to respond to menu or button selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

addBinActionItem

public javax.swing.JMenuItem addBinActionItem(javax.swing.JMenuItem menu,
                                              java.lang.String name,
                                              int mnemonic,
                                              java.awt.event.ActionListener listener)

Adds a given checkbox menu item to a given menu.

Parameters:

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

mnemonic - Keyboard mnemonic to use.

listener - Action listener to respond to menu selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

addBinActionItem

public javax.swing.JMenuItem addBinActionItem(javax.swing.JMenuItem menu,
                                              java.lang.String name,
                                              boolean isSelected,
                                              int mnemonic,
                                              java.awt.event.ActionListener listener)

Adds a given checkbox menu item to a given menu.

Parameters:

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

isSelected - Item will be selected if true.

mnemonic - Keyboard mnemonic to use.

listener - Action listener to respond to menu selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

addBinActionItem

public javax.swing.JMenuItem addBinActionItem(javax.swing.JMenuItem menu,
                                              java.lang.String name,
                                              int mnemonic,
                                              javax.swing.ButtonGroup bg,
                                              java.awt.event.ActionListener listener)

Adds a given checkbox menu item to a given menu.

Parameters:

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

mnemonic - Keyboard mnemonic to use.

bg - Button group for grouped toggle buttons/checkboxes.

listener - Action listener to respond to menu selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

addBinActionItem

public javax.swing.JMenuItem addBinActionItem(javax.swing.JMenuItem menu,
                                              java.lang.String name,
                                              java.lang.String icon,
                                              int mnemonic,
                                              java.awt.event.ActionListener listener)

Adds given checkbox menu and toggle button items. Assumes added item is not selected.

Parameters:

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

icon - Name of file containing icon or null if no icon.

mnemonic - Keyboard mnemonic to use.

listener - Action listener to respond to menu or button selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

addBinActionItem

public javax.swing.JMenuItem addBinActionItem(javax.swing.JMenuItem menu,
                                              java.lang.String name,
                                              boolean isSelected,
                                              java.lang.String icon,
                                              int mnemonic,
                                              java.awt.event.ActionListener listener)

Adds given checkbox menu and toggle button items.

Parameters:

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

isSelected - Item will be selected if true.

icon - Name of file containing icon or null if no icon.

mnemonic - Keyboard mnemonic to use.

listener - Action listener to respond to menu or button selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

addBinActionItem

public javax.swing.JMenuItem addBinActionItem(javax.swing.JMenuItem menu,
                                              java.lang.String name,
                                              java.lang.String icon,
                                              int mnemonic,
                                              javax.swing.ButtonGroup bg,
                                              java.awt.event.ActionListener listener)

Adds given checkbox menu and toggle button items.

Parameters:

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

icon - Name of file containing icon or null if no icon.

mnemonic - Keyboard mnemonic to use.

bg - Button group for grouped toggle buttons/checkboxes.

listener - Action listener to respond to menu or button selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

addBinActionItem

public javax.swing.JMenuItem addBinActionItem(javax.swing.JMenuItem menu,
                                              java.lang.String name,
                                              boolean isSelected,
                                              int mnemonic,
                                              javax.swing.ButtonGroup bg,
                                              java.awt.event.ActionListener listener)

Adds given checkbox menu and toggle button items.

Parameters:

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

isSelected - Item will be selected if true.

mnemonic - Keyboard mnemonic to use.

bg - Button group for grouped toggle buttons/checkboxes.

listener - Action listener to respond to menu or button selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

addBinActionItem

public javax.swing.JMenuItem addBinActionItem(javax.swing.JMenuItem menu,
                                              java.lang.String name,
                                              boolean isSelected,
                                              java.lang.String icon,
                                              int mnemonic,
                                              javax.swing.ButtonGroup bg,
                                              java.awt.event.ActionListener listener)

Adds given checkbox menu and toggle button items.

Parameters:

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

isSelected - Item will be selected if true.

icon - Name of file containing icon or null if no icon.

mnemonic - Keyboard mnemonic to use.

bg - Button group for grouped toggle buttons/checkboxes.

listener - Action listener to respond to menu or button selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

addBinActionItem

public javax.swing.JMenuItem addBinActionItem(javax.swing.JMenuItem menu,
                                              java.lang.String name,
                                              int mnemonic,
                                              int accelerator,
                                              java.awt.event.ActionListener listener)

Adds given checkbox menu and toggle button items.

Parameters:

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

mnemonic - Keyboard mnemonic to use.

accelerator - Keyboard accelerator to use. Uses the system-dependent mask (e.g. CTRL on windows, Command on MacOS).

listener - Action listener to respond to menu or button selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

addBinActionItem

public javax.swing.JMenuItem addBinActionItem(javax.swing.JMenuItem menu,
                                              java.lang.String name,
                                              boolean isSelected,
                                              java.lang.String icon,
                                              int mnemonic,
                                              int accelerator,
                                              javax.swing.ButtonGroup bg,
                                              java.awt.event.ActionListener listener)

Adds given checkbox menu and toggle button items.

Parameters:

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

isSelected - Item will be selected if true.

icon - Name of file containing icon or null if no icon.

mnemonic - Keyboard mnemonic to use.

accelerator - Keyboard accelerator to use. Uses the system-dependent mask (e.g. CTRL on windows, Command on MacOS).

bg - Button group for grouped toggle buttons/checkboxes.

listener - Action listener to respond to menu or button selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

addActionItem

public javax.swing.JMenuItem addActionItem(int type,
                                           javax.swing.JMenuItem menu,
                                           java.lang.String name,
                                           java.lang.String iconName,
                                           int mnemonic,
                                           int accelerator,
                                           javax.swing.ButtonGroup bg,
                                           java.awt.event.ActionListener listener)

Adds a given menu and button item.

Parameters:

type - Type of menu (NORMAL, CHECKBOX).

menu - Menu onto which this menu item is added.

name - Name on the new menu item to add.

iconName - Name of file containing icon or null if no icon.

mnemonic - Keyboard mnemonic to use.

accelerator - Keyboard accelerator to use. Uses the system-dependent mask (e.g. CTRL on windows, Command on MacOS).

bg - Button group for linking items together.

listener - Action listener to respond to menu or button selection.

Returns:

Reference to the menu item just created. This is useful for adding sub-menus.

getAction

public javax.swing.Action getAction(java.lang.String name)

Returns the action item (button or menu item) associated with the given name.

Parameters:

name - Name of action item to search for. Should be lower case without ellipsis.

Returns:

The first action item that has the given name, or null of nothing found. Should be all lower case and without ellipsis.

setMessage

public void setMessage(java.lang.String text)

Displays the given message in the status bar.

Parameters:

text - Message to display.

setMinProgress

public void setMinProgress(int minProgress)

Displays the minimum progress value.

Parameters:

minProgress - Minimum progress value.

setMaxProgress

public void setMaxProgress(int maxProgress)

Displays the maximum progress value.

Parameters:

maxProgress - Maximum progress value.

setProgress

public void setProgress(int progress)

Sets the current progress (should be between 0 and 100 unless minimum or maximum progress values have been changed.

Parameters:

progress - progress value.

showProgress

public void showProgress(boolean visible)

Shows or removes the progress bar from the frame.

Parameters:

visible - Progress bar will be visible if true;

addInterruptionListener

public void addInterruptionListener(JWInterruptionListener interruptionListener)

Adds the given interruption listener to this window. The listener will be informed whenever the progress bar is clicked.

Parameters:

interruptionListener - Object to be informed of an interruption request.

removeInterruptionListener

public boolean removeInterruptionListener(JWInterruptionListener interruptionListener)

Removes the given interruption listener from this window.

Parameters:

interruptionListener - Listener to be removed.

Returns:

True if listener was present and has been successfully removed.

run

public void run()

Displays the frame as part of a threaded process. This can be used when called with EventQueue.invokeLater() to ensure that the window is invoked in a thread-safe manner.

Specified by:

run in interface java.lang.Runnable

initWindow

protected void initWindow()

Performs any window initialisation that is required after the frame has been displayed. Not usually required, but this can be overridden for subclasses that need to perform some dynamic display changes or need to capture the graphics context of this frame.

closeDown

protected void closeDown()

Asks the user if they really want to quit, then closes.