You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pivot.apache.org by tv...@apache.org on 2009/03/20 19:16:17 UTC

svn commit: r756699 - in /incubator/pivot/trunk: tutorials/src/pivot/tutorials/Demo.java tutorials/src/pivot/tutorials/trees.wtkx wtk/src/pivot/wtk/Component.java wtk/src/pivot/wtk/TreeView.java wtk/src/pivot/wtk/content/TreeViewNodeEditor.java

Author: tvolkert
Date: Fri Mar 20 18:16:15 2009
New Revision: 756699

URL: http://svn.apache.org/viewvc?rev=756699&view=rev
Log:
Added working pivot.wtk.content.TreeViewNodeEditor, and updated tutorial demo to use it

Added:
    incubator/pivot/trunk/wtk/src/pivot/wtk/content/TreeViewNodeEditor.java
Modified:
    incubator/pivot/trunk/tutorials/src/pivot/tutorials/Demo.java
    incubator/pivot/trunk/tutorials/src/pivot/tutorials/trees.wtkx
    incubator/pivot/trunk/wtk/src/pivot/wtk/Component.java
    incubator/pivot/trunk/wtk/src/pivot/wtk/TreeView.java

Modified: incubator/pivot/trunk/tutorials/src/pivot/tutorials/Demo.java
URL: http://svn.apache.org/viewvc/incubator/pivot/trunk/tutorials/src/pivot/tutorials/Demo.java?rev=756699&r1=756698&r2=756699&view=diff
==============================================================================
--- incubator/pivot/trunk/tutorials/src/pivot/tutorials/Demo.java (original)
+++ incubator/pivot/trunk/tutorials/src/pivot/tutorials/Demo.java Fri Mar 20 18:16:15 2009
@@ -24,10 +24,8 @@
 import pivot.collections.Dictionary;
 import pivot.collections.List;
 import pivot.collections.Map;
-import pivot.collections.Sequence;
 import pivot.serialization.JSONSerializer;
 import pivot.util.CalendarDate;
-import pivot.util.Vote;
 import pivot.wtk.Action;
 import pivot.wtk.Alert;
 import pivot.wtk.Application;
@@ -35,14 +33,11 @@
 import pivot.wtk.Border;
 import pivot.wtk.Button;
 import pivot.wtk.ButtonPressListener;
-import pivot.wtk.ComponentKeyListener;
 import pivot.wtk.ComponentMouseButtonListener;
 import pivot.wtk.DragSource;
 import pivot.wtk.DropAction;
 import pivot.wtk.DropTarget;
 import pivot.wtk.ImageView;
-import pivot.wtk.Insets;
-import pivot.wtk.Keyboard;
 import pivot.wtk.ListView;
 import pivot.wtk.LocalManifest;
 import pivot.wtk.Manifest;
@@ -51,30 +46,22 @@
 import pivot.wtk.MessageType;
 import pivot.wtk.Mouse;
 import pivot.wtk.Point;
-import pivot.wtk.Popup;
 import pivot.wtk.Prompt;
 import pivot.wtk.PushButton;
 import pivot.wtk.Component;
 import pivot.wtk.Display;
-import pivot.wtk.Bounds;
-import pivot.wtk.ScrollPane;
 import pivot.wtk.Slider;
 import pivot.wtk.SliderValueListener;
 import pivot.wtk.Spinner;
 import pivot.wtk.TableView;
 import pivot.wtk.TableViewHeader;
 import pivot.wtk.TextArea;
-import pivot.wtk.TextInput;
-import pivot.wtk.TreeView;
 import pivot.wtk.Visual;
 import pivot.wtk.Window;
-import pivot.wtk.WindowStateListener;
 import pivot.wtk.content.CalendarDateSpinnerData;
 import pivot.wtk.content.NumericSpinnerData;
 import pivot.wtk.content.TableRow;
 import pivot.wtk.content.TableViewHeaderData;
-import pivot.wtk.content.TreeNode;
-import pivot.wtk.content.TreeViewNodeRenderer;
 import pivot.wtk.effects.ReflectionDecorator;
 import pivot.wtk.media.Image;
 import pivot.wtk.text.Document;
@@ -82,140 +69,6 @@
 import pivot.wtkx.WTKXSerializer;
 
 public class Demo implements Application {
-    private class TreeViewEditHandler
-        implements ComponentMouseButtonListener, ComponentKeyListener {
-        Sequence<Integer> path = null;
-        boolean armed = false;
-        Popup popup = null;
-
-        private int getNodeLabelIndent() {
-            int nodeLabelIndent = editableTreeView.getNodeIndent(path.getLength());
-
-            TreeViewNodeRenderer nodeRenderer =
-                (TreeViewNodeRenderer)editableTreeView.getNodeRenderer();
-
-            nodeLabelIndent += ((Insets)nodeRenderer.getStyles().get("padding")).left;
-            if (nodeRenderer.getShowIcon()) {
-                nodeLabelIndent += nodeRenderer.getIconWidth();
-                nodeLabelIndent += (Integer)nodeRenderer.getStyles().get("spacing");
-            }
-
-            return nodeLabelIndent;
-        }
-
-        public boolean mouseDown(Component component, Mouse.Button button, int x, int y) {
-            return false;
-        }
-
-        public boolean mouseUp(Component component, Mouse.Button button, int x, int y) {
-            path = editableTreeView.getNodeAt(y);
-
-            armed = (popup == null
-                && path != null
-                && Keyboard.getModifiers() == 0
-                && editableTreeView.isNodeSelected(path)
-                && x >= getNodeLabelIndent());
-
-            return false;
-        }
-
-        @SuppressWarnings("unchecked")
-        public boolean mouseClick(Component component, Mouse.Button button, int x, int y,
-            int count) {
-            if (armed
-                && count == 1) {
-                List<Object> treeData = (List<Object>)editableTreeView.getTreeData();
-                TreeNode nodeData = (TreeNode)Sequence.Tree.get(treeData, path);
-
-                Bounds nodeLabelBounds = editableTreeView.getNodeBounds(path);
-                int nodeLabelIndent = getNodeLabelIndent();
-                nodeLabelBounds.x += nodeLabelIndent;
-                nodeLabelBounds.width -= nodeLabelIndent;
-
-                Bounds viewportBounds = editableTreeViewScrollPane.getViewportBounds();
-
-                TextInput textInput = new TextInput();
-                textInput.setText(nodeData.getText());
-                textInput.setPreferredWidth(Math.min(nodeLabelBounds.width,
-                    viewportBounds.width - nodeLabelBounds.x));
-                textInput.getComponentKeyListeners().add(this);
-
-                Point treeViewCoordinates =
-                    editableTreeView.mapPointToAncestor(window.getDisplay(), 0, 0);
-
-                popup = new Popup(textInput);
-                popup.setLocation(treeViewCoordinates.x + nodeLabelBounds.x,
-                    treeViewCoordinates.y + nodeLabelBounds.y
-                    + (nodeLabelBounds.height - textInput.getPreferredHeight(-1)) / 2);
-
-                // Ensure that we clear the popup reference
-                popup.getWindowStateListeners().add(new WindowStateListener() {
-                    public Vote previewWindowOpen(Window window, Display display) {
-                        return Vote.APPROVE;
-                    }
-
-                    public void windowOpenVetoed(Window window, Vote reason) {
-                    }
-
-                    public void windowOpened(Window window) {
-                    }
-
-                    public Vote previewWindowClose(Window window) {
-                        return Vote.APPROVE;
-                    }
-
-                    public void windowCloseVetoed(Window window, Vote reason) {
-                    }
-
-                    public void windowClosed(Window window, Display display) {
-                        popup = null;
-                    }
-                });
-
-                popup.open(editableTreeView);
-
-                textInput.requestFocus();
-            }
-
-            armed = false;
-
-            return false;
-        }
-
-        public boolean keyTyped(Component component, char character) {
-            return false;
-        }
-
-        @SuppressWarnings("unchecked")
-        public boolean keyPressed(Component component, int keyCode,
-            Keyboard.KeyLocation keyLocation) {
-            if (keyCode == Keyboard.KeyCode.ENTER) {
-                List<Object> treeData = (List<Object>)editableTreeView.getTreeData();
-                TreeNode nodeData = (TreeNode)Sequence.Tree.get(treeData, path);
-
-                TextInput textInput = (TextInput)component;
-                String text = textInput.getText();
-
-                nodeData.setText(text);
-
-                popup.close();
-                editableTreeView.requestFocus();
-            }
-
-            if (keyCode == Keyboard.KeyCode.ESCAPE) {
-                popup.close();
-                editableTreeView.requestFocus();
-            }
-
-            return false;
-        }
-
-        public boolean keyReleased(Component component, int keyCode,
-            Keyboard.KeyLocation keyLocation) {
-            return false;
-        }
-    }
-
     private MenuPopup menuPopup = null;
     private ImageView menuImageView = null;
 
@@ -228,9 +81,6 @@
     private TableView customTableView = null;
     private TableViewHeader sortableTableViewHeader = null;
 
-    private TreeView editableTreeView = null;
-    private ScrollPane editableTreeViewScrollPane = null;
-
     private PushButton alertButton = null;
     private PushButton promptButton = null;
 
@@ -321,11 +171,11 @@
 
         // Sliders
         SliderValueListener sliderValueListener = new SliderValueListener() {
-        	public void valueChanged(Slider slider, int previousValue) {
-        		Color color = new Color(redSlider.getValue(), greenSlider.getValue(),
-    				blueSlider.getValue());
-        		colorBorder.getStyles().put("backgroundColor", color);
-        	}
+            public void valueChanged(Slider slider, int previousValue) {
+                Color color = new Color(redSlider.getValue(), greenSlider.getValue(),
+                    blueSlider.getValue());
+                colorBorder.getStyles().put("backgroundColor", color);
+            }
         };
 
         redSlider = (Slider)wtkxSerializer.getObjectByName("spinners.redSlider");
@@ -337,20 +187,16 @@
         blueSlider = (Slider)wtkxSerializer.getObjectByName("spinners.blueSlider");
         blueSlider.getSliderValueListeners().add(sliderValueListener);
 
-    	Color color = new Color(redSlider.getValue(), greenSlider.getValue(),
-			blueSlider.getValue());
+        Color color = new Color(redSlider.getValue(), greenSlider.getValue(),
+            blueSlider.getValue());
         colorBorder = (Border)wtkxSerializer.getObjectByName("spinners.colorBorder");
-		colorBorder.getStyles().put("backgroundColor", color);
+        colorBorder.getStyles().put("backgroundColor", color);
 
         sortableTableView = (TableView)wtkxSerializer.getObjectByName("tables.sortableTableView");
         sortableTableViewHeader = (TableViewHeader)wtkxSerializer.getObjectByName("tables.sortableTableViewHeader");
         customTableView = (TableView)wtkxSerializer.getObjectByName("tables.customTableView");
         initializeTableViews();
 
-        editableTreeView = (TreeView)wtkxSerializer.getObjectByName("trees.editableTreeView");
-        editableTreeViewScrollPane = (ScrollPane)wtkxSerializer.getObjectByName("trees.editableTreeViewScrollPane");
-        initializeEditableTreeView();
-
         DragSource imageDragSource = new DragSource() {
             private Image image = null;
             private Point offset = null;
@@ -511,38 +357,33 @@
 
         customTableView.getComponentMouseButtonListeners().add(new ComponentMouseButtonListener() {
             public boolean mouseDown(Component component, Mouse.Button button, int x, int y) {
-            	return false;
+               return false;
             }
 
             public boolean mouseUp(Component component, Mouse.Button button, int x, int y) {
-            	return false;
+               return false;
             }
 
             public boolean mouseClick(Component component, Mouse.Button button, int x, int y, int count) {
-            	if (button == Mouse.Button.LEFT) {
-            	    List<CustomTableRow> customTableData =
-            	        (List<CustomTableRow>)customTableView.getTableData();
-
-            		int columnIndex = customTableView.getColumnAt(x);
-            		if (columnIndex == 0) {
-            			int rowIndex = customTableView.getRowAt(y);
-            			CustomTableRow row = customTableData.get(rowIndex);
-
-            			row.setA(!row.getA());
-            			customTableData.update(rowIndex, row);
-            		}
-            	}
+               if (button == Mouse.Button.LEFT) {
+                   List<CustomTableRow> customTableData =
+                       (List<CustomTableRow>)customTableView.getTableData();
+
+                  int columnIndex = customTableView.getColumnAt(x);
+                  if (columnIndex == 0) {
+                     int rowIndex = customTableView.getRowAt(y);
+                     CustomTableRow row = customTableData.get(rowIndex);
+
+                     row.setA(!row.getA());
+                     customTableData.update(rowIndex, row);
+                  }
+               }
 
-            	return false;
+               return false;
             }
         });
     }
 
-    private void initializeEditableTreeView() {
-        TreeViewEditHandler treeViewEditHandler = new TreeViewEditHandler();
-        editableTreeView.getComponentMouseButtonListeners().add(treeViewEditHandler);
-    }
-
     private void initializeNumericSpinner(Spinner numericSpinner) {
         NumericSpinnerData numericSpinnerData = new NumericSpinnerData(0, 256, 4);
         numericSpinner.setSpinnerData(numericSpinnerData);

Modified: incubator/pivot/trunk/tutorials/src/pivot/tutorials/trees.wtkx
URL: http://svn.apache.org/viewvc/incubator/pivot/trunk/tutorials/src/pivot/tutorials/trees.wtkx?rev=756699&r1=756698&r2=756699&view=diff
==============================================================================
--- incubator/pivot/trunk/tutorials/src/pivot/tutorials/trees.wtkx (original)
+++ incubator/pivot/trunk/tutorials/src/pivot/tutorials/trees.wtkx Fri Mar 20 18:16:15 2009
@@ -79,6 +79,9 @@
                                     <nodeRenderer>
                                         <content:TreeViewNodeRenderer showIcon="true"/>
                                     </nodeRenderer>
+                                    <nodeEditor>
+                                        <content:TreeViewNodeEditor/>
+                                    </nodeEditor>
                                 </TreeView>
                             </view>
                         </ScrollPane>

Modified: incubator/pivot/trunk/wtk/src/pivot/wtk/Component.java
URL: http://svn.apache.org/viewvc/incubator/pivot/trunk/wtk/src/pivot/wtk/Component.java?rev=756699&r1=756698&r2=756699&view=diff
==============================================================================
--- incubator/pivot/trunk/wtk/src/pivot/wtk/Component.java (original)
+++ incubator/pivot/trunk/wtk/src/pivot/wtk/Component.java Fri Mar 20 18:16:15 2009
@@ -1512,6 +1512,47 @@
     }
 
     /**
+     * Alters the specified bounds such that they fit within the viewport of
+     * all <tt>Viewport</tt> ancestors of this component.
+     */
+    public void constrainToViewportBounds(Bounds area) {
+        // TODO
+        /*
+        Component component = this;
+
+        int top = area.y;
+        int left = area.x;
+        int bottom = area.y + area.height - 1;
+        int right = area.x + area.width - 1;
+
+        while (component != null) {
+            int minTop = 0;
+            int minLeft = 0;
+            int maxBottom = component.getHeight() - 1;
+            int maxRight = component.getWidth() - 1;
+
+            if (component instanceof Viewport) {
+                Viewport viewport = (Viewport)component;
+                Bounds viewportBounds = viewport.getViewportBounds();
+
+                // Adjust constraints per the viewport bounds
+                minTop = viewportBounds.y;
+                minLeft = viewportBounds.x;
+                maxBottom = viewportBounds.y + viewportBounds.height - 1;
+                maxRight = viewportBounds.x + viewportBounds.width - 1;
+            }
+
+            top = component.y + Math.max(top, minTop);
+            left = component.x + Math.max(left, minLeft);
+            bottom = component.y + Math.max(Math.min(bottom, maxBottom), -1);
+            right = component.x + Math.max(Math.min(right, maxRight), -1);
+
+            component = component.getParent();
+        }
+        */
+    }
+
+    /**
      * Returns the component's valid state.
      *
      * @return

Modified: incubator/pivot/trunk/wtk/src/pivot/wtk/TreeView.java
URL: http://svn.apache.org/viewvc/incubator/pivot/trunk/wtk/src/pivot/wtk/TreeView.java?rev=756699&r1=756698&r2=756699&view=diff
==============================================================================
--- incubator/pivot/trunk/wtk/src/pivot/wtk/TreeView.java (original)
+++ incubator/pivot/trunk/wtk/src/pivot/wtk/TreeView.java Fri Mar 20 18:16:15 2009
@@ -469,18 +469,20 @@
         public void itemUpdated(List<Object> list, int index, Object previousItem) {
             Sequence<Integer> path = getPath();
 
-            // Release child handler
-            BranchHandler handler = update(index, null);
+            if (list.get(index) != previousItem) {
+                // Release child handler
+                BranchHandler handler = update(index, null);
 
-            if (handler != null) {
-                handler.release();
-            }
+                if (handler != null) {
+                    handler.release();
+                }
 
-            // Update our data structures
-            clearPaths(expandedPaths, path, index);
-            clearPaths(selectedPaths, path, index);
-            clearPaths(disabledPaths, path, index);
-            clearPaths(checkedPaths, path, index);
+                // Update our data structures
+                clearPaths(expandedPaths, path, index);
+                clearPaths(selectedPaths, path, index);
+                clearPaths(disabledPaths, path, index);
+                clearPaths(checkedPaths, path, index);
+            }
 
             // Notify listeners
             treeViewNodeListeners.nodeUpdated(TreeView.this, path, index);

Added: incubator/pivot/trunk/wtk/src/pivot/wtk/content/TreeViewNodeEditor.java
URL: http://svn.apache.org/viewvc/incubator/pivot/trunk/wtk/src/pivot/wtk/content/TreeViewNodeEditor.java?rev=756699&view=auto
==============================================================================
--- incubator/pivot/trunk/wtk/src/pivot/wtk/content/TreeViewNodeEditor.java (added)
+++ incubator/pivot/trunk/wtk/src/pivot/wtk/content/TreeViewNodeEditor.java Fri Mar 20 18:16:15 2009
@@ -0,0 +1,339 @@
+/*
+ * Copyright (c) 2009 VMware, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package pivot.wtk.content;
+
+import pivot.collections.ArrayList;
+import pivot.collections.List;
+import pivot.collections.Sequence;
+import pivot.util.Vote;
+import pivot.wtk.Bounds;
+import pivot.wtk.Component;
+import pivot.wtk.ComponentKeyListener;
+import pivot.wtk.Container;
+import pivot.wtk.ContainerMouseListener;
+import pivot.wtk.Display;
+import pivot.wtk.Insets;
+import pivot.wtk.Keyboard;
+import pivot.wtk.Mouse;
+import pivot.wtk.Point;
+import pivot.wtk.Popup;
+import pivot.wtk.TextInput;
+import pivot.wtk.TreeView;
+import pivot.wtk.TreeViewListener;
+import pivot.wtk.TreeViewBranchListener;
+import pivot.wtk.TreeViewNodeListener;
+import pivot.wtk.TreeViewNodeStateListener;
+import pivot.wtk.TreeViewSelectionListener;
+import pivot.wtk.Window;
+import pivot.wtk.WindowStateListener;
+import pivot.wtk.content.TreeNode;
+import pivot.wtk.content.TreeViewNodeRenderer;
+
+/**
+ * Default tree view node editor, which allows the user to edit the text of a
+ * tree node in a <tt>TextInput</tt>. It is only intended to work with
+ * {@link TreeNode} data and {@link TreeViewNodeRenderer} renderers.
+ *
+ * @author tvolkert
+ */
+public class TreeViewNodeEditor implements TreeView.NodeEditor {
+    /**
+     * Responsible for "edit initialization" and "edit finalization" tasks when
+     * the edit popup is opened and closed, respectively.
+     *
+     * @author tvolkert
+     */
+    private WindowStateListener popupStateHandler = new WindowStateListener() {
+        public Vote previewWindowOpen(Window window, Display display) {
+            return Vote.APPROVE;
+        }
+
+        public void windowOpenVetoed(Window window, Vote reason) {
+        }
+
+        public void windowOpened(Window window) {
+            // Add this as a container mouse listener on display
+            Display display = window.getDisplay();
+            display.getContainerMouseListeners().add(displayMouseHandler);
+
+            treeView.getTreeViewListeners().add(treeViewHandler);
+            treeView.getTreeViewBranchListeners().add(treeViewHandler);
+            treeView.getTreeViewNodeListeners().add(treeViewHandler);
+            treeView.getTreeViewNodeStateListeners().add(treeViewHandler);
+            treeView.getTreeViewSelectionListeners().add(treeViewHandler);
+        }
+
+        public Vote previewWindowClose(Window window) {
+            return Vote.APPROVE;
+        }
+
+        public void windowCloseVetoed(Window window, Vote reason) {
+        }
+
+        public void windowClosed(Window window, Display display) {
+            // Clean up
+            display.getContainerMouseListeners().remove(displayMouseHandler);
+            treeView.getTreeViewListeners().remove(treeViewHandler);
+            treeView.getTreeViewBranchListeners().remove(treeViewHandler);
+            treeView.getTreeViewNodeListeners().remove(treeViewHandler);
+            treeView.getTreeViewNodeStateListeners().remove(treeViewHandler);
+            treeView.getTreeViewSelectionListeners().remove(treeViewHandler);
+
+            // Restore focus to the tree view
+            treeView.requestFocus();
+
+            // Free memory
+            treeView = null;
+            editPath = null;
+            popup = null;
+        }
+    };
+
+    /**
+     * Responsible for saving or cancelling the edit based on the user pressing
+     * the <tt>ENTER</tt> key or the <tt>ESCAPE</tt> key, respectively.
+     *
+     * @author tvolkert
+     */
+    private ComponentKeyListener textInputKeyHandler = new ComponentKeyListener() {
+        @SuppressWarnings("unchecked")
+        public boolean keyPressed(Component component, int keyCode, Keyboard.KeyLocation keyLocation) {
+            if (keyCode == Keyboard.KeyCode.ENTER) {
+                List<?> treeData = treeView.getTreeData();
+                TreeNode nodeData = (TreeNode)Sequence.Tree.get(treeData, editPath);
+
+                // Update the node data
+                TextInput textInput = (TextInput)component;
+                String text = textInput.getText();
+                nodeData.setText(text);
+
+                // Notify the tree branch that the child was updated. Our
+                // treeViewHandler will be notified of this edit and close
+                // the popup for us.
+                int n = editPath.getLength();
+                if (n == 1) {
+                    // Base case
+                    int index = editPath.get(0);
+                    ((List<TreeNode>)treeData).update(index, nodeData);
+                } else {
+                    Sequence<Integer> parentPath = new ArrayList<Integer>(editPath, 0, n - 1);
+                    TreeBranch parentData = (TreeBranch)Sequence.Tree.get(treeData, parentPath);
+                    int index = editPath.get(n - 1);
+                    parentData.update(index, nodeData);
+                }
+            } else if (keyCode == Keyboard.KeyCode.ESCAPE) {
+                // Close the popup without saving (cancel)
+                popup.close();
+            }
+
+            return false;
+        }
+
+        public boolean keyReleased(Component component, int keyCode, Keyboard.KeyLocation keyLocation) {
+            return false;
+        }
+
+        public boolean keyTyped(Component component, char character) {
+            return false;
+        }
+    };
+
+    /**
+     * Responsible for closing the popup whenever the user clicks outside the
+     * bounds of the popup.
+     *
+     * @author tvolkert
+     */
+    private ContainerMouseListener displayMouseHandler = new ContainerMouseListener() {
+        public void mouseMove(Container container, int x, int y) {
+            // No-op
+        }
+
+        public void mouseDown(Container container, Mouse.Button button, int x, int y) {
+            // If the event did not occur within a window that is owned by
+            // this popup, close the popup
+            Display display = (Display)container;
+            Window window = (Window)display.getComponentAt(x, y);
+
+            if (window == null
+                || !popup.isOwningAncestorOf(window)) {
+                popup.close();
+            }
+        }
+
+        public void mouseUp(Container container, Mouse.Button button, int x, int y) {
+            // No-op
+        }
+
+        public void mouseWheel(Container container, Mouse.ScrollType scrollType,
+            int scrollAmount, int wheelRotation, int x, int y) {
+            // No-op
+        }
+    };
+
+    /**
+     * Responsible for cancelling the edit if any relevant changes are made to
+     * the tree view while we're editing.
+     */
+    private class TreeViewHandler implements
+        TreeViewListener, TreeViewBranchListener, TreeViewNodeListener,
+        TreeViewNodeStateListener, TreeViewSelectionListener {
+        private TreeView.PathComparator pathComparator = new TreeView.PathComparator();
+
+        public void treeDataChanged(TreeView treeView, List<?> previousTreeData) {
+            popup.close();
+        }
+
+        public void nodeRendererChanged(TreeView treeView, TreeView.NodeRenderer previousNodeRenderer) {
+            popup.close();
+        }
+
+        public void nodeEditorChanged(TreeView treeView, TreeView.NodeEditor previousNodeEditor) {
+            popup.close();
+        }
+
+        public void selectModeChanged(TreeView treeView, TreeView.SelectMode previousSelectMode) {
+            popup.close();
+        }
+
+        public void checkmarksEnabledChanged(TreeView treeView) {
+            popup.close();
+        }
+
+        public void showMixedCheckmarkStateChanged(TreeView treeView) {
+        }
+
+        public void branchExpanded(TreeView treeView, Sequence<Integer> path) {
+            if (pathComparator.compare(path, editPath) < 0) {
+                popup.close();
+            }
+        }
+
+        public void branchCollapsed(TreeView treeView, Sequence<Integer> path) {
+            if (pathComparator.compare(path, editPath) < 0) {
+                popup.close();
+            }
+        }
+
+        public void nodeInserted(TreeView treeView, Sequence<Integer> path, int index) {
+            Sequence<Integer> childPath = new ArrayList<Integer>(path);
+            childPath.add(index);
+
+            if (pathComparator.compare(childPath, editPath) <= 0) {
+                popup.close();
+            }
+        }
+
+        public void nodesRemoved(TreeView treeView, Sequence<Integer> path, int index, int count) {
+            Sequence<Integer> childPath = new ArrayList<Integer>(path);
+            childPath.add(index);
+
+            if (pathComparator.compare(childPath, editPath) <= 0) {
+                popup.close();
+            }
+        }
+
+        public void nodeUpdated(TreeView treeView, Sequence<Integer> path, int index) {
+            Sequence<Integer> childPath = new ArrayList<Integer>(path);
+            childPath.add(index);
+
+            if (pathComparator.compare(childPath, editPath) <= 0) {
+                popup.close();
+            }
+        }
+
+        public void nodesSorted(TreeView treeView, Sequence<Integer> path) {
+            if (Sequence.Tree.isDescendant(path, editPath)) {
+                popup.close();
+            }
+        }
+
+        public void nodeDisabledChanged(TreeView treeView, Sequence<Integer> path) {
+            if (pathComparator.compare(path, editPath) == 0) {
+                popup.close();
+            }
+        }
+
+        public void nodeCheckStateChanged(TreeView treeView, Sequence<Integer> path,
+            TreeView.NodeCheckState previousCheckState) {
+        }
+
+        public void selectedPathAdded(TreeView treeView, Sequence<Integer> path) {
+        }
+
+        public void selectedPathRemoved(TreeView treeView, Sequence<Integer> path) {
+            if (pathComparator.compare(path, editPath) == 0) {
+                popup.close();
+            }
+        }
+
+        public void selectedPathsChanged(TreeView treeView,
+            Sequence<Sequence<Integer>> previousSelectedPaths) {
+            popup.close();
+        }
+    }
+
+    private TreeView treeView = null;
+    private Sequence<Integer> editPath = null;
+    private Popup popup = null;
+
+    private TreeViewHandler treeViewHandler = new TreeViewHandler();
+
+    public void edit(TreeView treeView, Sequence<Integer> path) {
+        if (this.treeView != null) {
+            throw new IllegalStateException("Currently editing.");
+        }
+
+        this.treeView = treeView;
+        this.editPath = path;
+
+        TreeViewNodeRenderer nodeRenderer = (TreeViewNodeRenderer)treeView.getNodeRenderer();
+
+        // Get the data being edited
+        List<?> treeData = treeView.getTreeData();
+        TreeNode nodeData = (TreeNode)Sequence.Tree.get(treeData, path);
+
+        // Calculate the indent to the node's text
+        int textIndent = treeView.getNodeIndent(path.getLength());
+        textIndent += ((Insets)nodeRenderer.getStyles().get("padding")).left;
+        if (nodeRenderer.getShowIcon()) {
+            textIndent += nodeRenderer.getIconWidth();
+            textIndent += (Integer)nodeRenderer.getStyles().get("spacing");
+        }
+
+        // Calculate the bounds of the node's text
+        Bounds textBounds = treeView.getNodeBounds(path);
+        textBounds.x += textIndent;
+        textBounds.width -= textIndent;
+
+        // Constrain the bounds by what is visible through Viewport ancestors
+        treeView.constrainToViewportBounds(textBounds);
+
+        TextInput textInput = new TextInput();
+        textInput.setText(nodeData.getText());
+        textInput.setPreferredWidth(textBounds.width);
+        textInput.getComponentKeyListeners().add(textInputKeyHandler);
+
+        popup = new Popup(textInput);
+        Point displayCoordinates = treeView.mapPointToAncestor(treeView.getDisplay(), 0, 0);
+        popup.setLocation(displayCoordinates.x + textBounds.x, displayCoordinates.y +
+            textBounds.y + (textBounds.height - textInput.getPreferredHeight(-1)) / 2);
+        popup.getWindowStateListeners().add(popupStateHandler);
+        popup.open(treeView);
+
+        textInput.requestFocus();
+    }
+}