All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class edu.mit.ai.psg.ui.outlines.OutlineTree

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.Container
                   |
                   +----java.awt.Panel
                           |
                           +----edu.mit.ai.psg.ui.outlines.OutlineTree

public class OutlineTree

extends Panel

implements ActionListener

See method generateChildren() for instructions on how to add children.

Derived classes may tailor the behavior to generate children when item is expanded. See method actionPerformed() for how to do this.

Derived classes may tailor the popup menu provided with for their instances by adding an appropriate title string identifying the moused object at the top of its pop-up menu by overriding method addPopupMenuTitle(), or by adding additional popup menu items specific to the derived outline by overriding method addPopupMenuItems().

Author:

CarlManning, caroma@ai.mit.edu
Copyright (c) 1997, 1998 Massachusetts Institute of Technology

OutlineTree(Component)

actionPerformed(ActionEvent)

ActionPerformed: Toggles whether tree is displayed expanded (showing children) or not (only showing root).

addImpl(Component, Object, int)

addPopupMenuItems(PopupMenu)

Add popup menu items specific to this kind of outline, if any

addPopupMenuTitle(PopupMenu)

Add a menu item identifying the object the popup menu is for.

doLayout()

generateChildren()

GenerateChildren(): Subclasses may override this method with one which generates children.

getMinimumSize()

getPreferredSize()

getRootComponent()

hasChildren()

invalidateAndRepaintTree()

isExpanded()

makeLabelComponent(String)

setExpanded(boolean)

 public OutlineTree(Component component)

 public Component getRootComponent()

 public boolean isExpanded()

 public void setExpanded(boolean isExpanded)

 public boolean hasChildren()

 public void generateChildren()

GenerateChildren(): Subclasses may override this method with one which generates children. This method removes parent's open/close button if this has no children. Overriding methods may call super.generateChildren() after all children have been generated if they want button removed in the no child case.

To add children, for each child, call this from subclass method:

.       this.add(Outliner.makeOutlineComponent(childObject),
.                makeLabelComponent("childLabel"));

Or if children are not labeled, then call this instead:

.       this.add(Outliner.makeOutlineComponent(obj));

 public Component makeLabelComponent(String string)

 public void addPopupMenuTitle(PopupMenu menu)

Add a menu item identifying the object the popup menu is for.

 public void addPopupMenuItems(PopupMenu menu)

Add popup menu items specific to this kind of outline, if any

 public void actionPerformed(ActionEvent e)

ActionPerformed: Toggles whether tree is displayed expanded (showing children) or not (only showing root). If you want to generate children when opened, override the method with something like:

      
.       public void actionPerformed(ActionEvent e) {
.         if (! isExpanded() && ! hasChildren())
.            generateChildren();
.         super.actionPerformed(e)
.       } 

 public void invalidateAndRepaintTree()

 public void addImpl(Component comp,
                     Object label,
                     int index)

Overrides:

addImpl in class Container

 public void doLayout()

Overrides:

doLayout in class Container

 public Dimension getPreferredSize()

Overrides:

getPreferredSize in class Container

 public Dimension getMinimumSize()

Overrides:

getMinimumSize in class Container

All Packages  Class Hierarchy  This Package  Previous  Next  Index