WindowManager (ChargerLib)

Object
- chargerlib.WindowManager

```
public class WindowManager
extends Object
```
Manages multiple windows, where windows may be added and removed dynamically. Its basic use is in creating and handling events for a "Windows" menu. Since all methods are static, there is effectively only one WindowManager per session. Assumes that a managed window is of class Window or one of its sub-classes.

See Also:

ManagedWindow

Field Summary

Fields
Modifier and Type	Field and Description
`private static Hashtable`	`acceleratorList` for each window, keeps whatever accelerator key has been stored for it
`static boolean`	`enableTracing`
`private static Hashtable<ManagedWindow,String>`	`fileWindowLookup` Keeps the window file entries in the form of ( file, ManagedWindow) pairs
`private static boolean`	`listToBeSorted`
`static int`	`MAX_MENU_LABEL_LENGTH`
`static String`	`MENU_LABEL_PREFIX_IF_TOO_LONG`
`private static Hashtable<JMenuItem,ManagedWindow>`	`menuWindowLookup` Keeps the window entries in the form of (MenuItemLabel, ManagedWindow) pairs
`private static ArrayList<ManagedWindow>`	`windowList` The global list of all managed windows, independent of any menus
`private static Hashtable<ManagedWindow,String>`	`windowMenuLabelLookup` Each window has a particular string that appears in the menu label.

Constructor Summary

Constructors
Constructor and Description

WindowManager()

Constructors
Constructor and Description
`WindowManager()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`changeFilename(ManagedWindow mw, String filename)` Tell the window manager that it needs to change the filename it's using for this window.
`static ManagedWindow`	`chooseWindowFromMenu(JMenuItem mi)` Brings to the front whatever window goes with the menu item specified.
`static void`	`forgetWindow(ManagedWindow mw)` Notify this window manager that a window no longer needs to be managed.
`static ManagedWindow`	`getWindowFromFile(File f)`
`static ManagedWindow`	`getWindowFromFile(File f, Class desiredClass)` Find the window that corresponds to a particular file.
`static ManagedWindow`	`getWindowFromMenuItem(JMenuItem mi)`
`private static void`	`insertNewWindowIntoList(ManagedWindow mw)`
`static void`	`makeMenu(ManagedWindow currentWindow)` Create menu entries for every managed window.
`static void`	`manageWindow(ManagedWindow mw)` Notify this window manager that a window wants to be managed.
`static void`	`manageWindow(ManagedWindow mw, KeyStroke key)` Notify this window manager that a window wants to be managed.
`static void`	`refreshWindowMenuList(ManagedWindow activeFrame)` Refreshes the windows menu lists for the given window.
`static void`	`setSorted(boolean sortme)`
`static String`	`shortenMenuLabel(String label)`
`static void`	`windowActionPerformed(ActionEvent e)` Handles the window menu selections for the EditFrame, HubFrame, Craft and CraftWindow classes.

Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - enableTracing
```
public static boolean enableTracing
```
  - MAX_MENU_LABEL_LENGTH
```
public static final int MAX_MENU_LABEL_LENGTH
```
    See Also:
    
    Constant Field Values
  - MENU_LABEL_PREFIX_IF_TOO_LONG
```
public static final String MENU_LABEL_PREFIX_IF_TOO_LONG
```
    See Also:
    
    Constant Field Values
  - menuWindowLookup
```
private static Hashtable<JMenuItem,ManagedWindow> menuWindowLookup
```
    Keeps the window entries in the form of (MenuItemLabel, ManagedWindow) pairs
  - windowMenuLabelLookup
```
private static Hashtable<ManagedWindow,String> windowMenuLabelLookup
```
    Each window has a particular string that appears in the menu label.
  - fileWindowLookup
```
private static Hashtable<ManagedWindow,String> fileWindowLookup
```
    Keeps the window file entries in the form of ( file, ManagedWindow) pairs
  - windowList
```
private static ArrayList<ManagedWindow> windowList
```
    The global list of all managed windows, independent of any menus
  - acceleratorList
```
private static Hashtable acceleratorList
```
    for each window, keeps whatever accelerator key has been stored for it
  - listToBeSorted
```
private static boolean listToBeSorted
```
- Constructor Detail
  - WindowManager
```
public WindowManager()
```
- Method Detail
  - manageWindow
```
public static void manageWindow(ManagedWindow mw)
```
    Notify this window manager that a window wants to be managed.
    
    Parameters:
    
    mw - the window to be managed; must implement the ManagedWindow interface.
  - manageWindow
```
public static void manageWindow(ManagedWindow mw,
                                KeyStroke key)
```
    Notify this window manager that a window wants to be managed. Set up listeners so that the window menu is refreshed whenever the window is activated, and that it is removed when the window is closed.
    
    Parameters:
    
    mw - the window to be managed; must implement the ManagedWindow interface.
    
    key - the accelerator to be associated with this window's menu item. If null then do not include an accelerator.
  - forgetWindow
```
public static void forgetWindow(ManagedWindow mw)
```
    Notify this window manager that a window no longer needs to be managed. If the window wasn't already in the list to be managed, then ignore this.
    
    Parameters:
    
    mw - the window to be removed; if not found, then do nothing.
  - getWindowFromMenuItem
```
public static ManagedWindow getWindowFromMenuItem(JMenuItem mi)
```
  - chooseWindowFromMenu
```
public static ManagedWindow chooseWindowFromMenu(JMenuItem mi)
```
    Brings to the front whatever window goes with the menu item specified.
    
    Parameters:
    
    mi - A menu item previously associated with a particular window by makeMenu.
    
    See Also:
    
    makeMenu(chargerlib.ManagedWindow)
  - insertNewWindowIntoList
```
private static void insertNewWindowIntoList(ManagedWindow mw)
```
  - makeMenu
```
public static void makeMenu(ManagedWindow currentWindow)
```
    Create menu entries for every managed window. Uses only the last
    
    Parameters:
    
    menu - The menu (usually a "Windows" menu) to which items are to be added.
    
    currentWindow - put a check box next to this window's entry.
    
    See Also:
    
    ManagedWindow
  - shortenMenuLabel
```
public static String shortenMenuLabel(String label)
```
  - windowActionPerformed
```
public static void windowActionPerformed(ActionEvent e)
```
    Handles the window menu selections for the EditFrame, HubFrame, Craft and CraftWindow classes.
  - setSorted
```
public static void setSorted(boolean sortme)
```
  - changeFilename
```
public static void changeFilename(ManagedWindow mw,
                                  String filename)
```
    Tell the window manager that it needs to change the filename it's using for this window.
    
    Parameters:
    
    mw - The current window being managed
    
    filename - The new filename
  - getWindowFromFile
```
public static ManagedWindow getWindowFromFile(File f)
```
  - getWindowFromFile
```
public static ManagedWindow getWindowFromFile(File f,
                                              Class desiredClass)
```
    Find the window that corresponds to a particular file. This is the reverse lookup from what the usual menu item does.
    
    Parameters:
    
    f - A file that is associated with some window.
    
    Returns:
    
    The window that's associated with this file. If there is no such window, return null.
  - refreshWindowMenuList
```
public static void refreshWindowMenuList(ManagedWindow activeFrame)
```
    Refreshes the windows menu lists for the given window. Uses whatever JMenu the window decides it wants filled. This is usually a "Windows" menu in the frame itself, but it might be one from a sub-class or associated class.
    
    Parameters:
    
    m -
    
    activeFrame -
    
    See Also:
    
    ManagedWindow.getWindowMenu()

Class WindowManager

Field Summary

Constructor Summary

Method Summary

Methods inherited from class Object

Field Detail

enableTracing

MAX_MENU_LABEL_LENGTH

MENU_LABEL_PREFIX_IF_TOO_LONG

menuWindowLookup

windowMenuLabelLookup

fileWindowLookup

windowList

acceleratorList

listToBeSorted

Constructor Detail

WindowManager

Method Detail

manageWindow

manageWindow

forgetWindow

getWindowFromMenuItem

chooseWindowFromMenu

insertNewWindowIntoList

makeMenu

shortenMenuLabel

windowActionPerformed

setSorted

changeFilename

getWindowFromFile

getWindowFromFile

refreshWindowMenuList