<change id="TreeView.editNode">

        <api name="explorer"/>

        <summary><code>TreeView.editNode</code> added</summary>

        <version major="6" minor="60"/>

        <date day="14" month="11" year="2014"/>

        <author login="tboudreau"/>

        <compatibility binary="compatible" source="incompatible" deprecation="no" deletion="no" addition="yes"/>

        <description>

            Added <code>TreeView.editNode(Node)</code> to programmatically

            enter inline-edit mode on a TreeView. Method is thread-safe.

        </description>

        <class package="org.openide.explorer.view" name="TreeView"/>

        <issue number="182427"/>

    </change>

import org.openide.util.Parameters;

    /**

     * Initiate inline-edit mode for a Node, expanding its parent

     * and selecting it if necessary.  This method is thread-safe.

     * <p/>

     * If this TreeView is not actually on-screen when the edit is

     * initiated (for example, a call after the call to editNode() removes

     * it from the AWT hierarchy) then this method logs an error and does

     * nothing.

     *

     * @since 6.60

     * @param node A node whose name should be edited visually by the user

     */

    public final void editNode(final Node node) {

        Parameters.notNull("node", node); //NOI18N

        //Do not use VisualizerNode.runSafe(), which will call

        //EQ.invokeAndWait()

        Mutex.EVENT.readAccess(new EditInitiator(node));

    }

    private final class EditInitiator implements Runnable {

        private final Node node;

        EditInitiator (Node target) {

            this.node = target;

        }

        @Override

        public void run() {

            if (!isDisplayable()) {

                Logger.getLogger(TreeView.class.getName()).log(

                        Level.WARNING, "Attempt to edit node {0} but " + //NOI18N

                        "component not on screen", node); //NOI18N

                return;

            }

            lookupExplorerManager();

            TreePath path = getTreePath(node);

            if (path == null) {

                throw new IllegalArgumentException ("Unknown node " + node); //NOI18N

            }

            if (!tree.isExpanded(path)) {

                tree.expandPath(path);

            }

            tree.setSelectionPath(path);

            tree.startEditingAtPath(path);

        }

    }

    Ed ed() { //editNodeTest

        return (Ed) realEditor;

    }

        JTextField comp() {  //editNodeTest

            return (JTextField) super.getComponent();

        }

import java.awt.EventQueue;

import java.awt.event.HierarchyEvent;

import java.awt.event.HierarchyListener;

import java.awt.event.WindowAdapter;

import java.awt.event.WindowEvent;

import java.util.concurrent.CountDownLatch;

import javax.swing.JTextField;

import org.openide.explorer.view.TreeViewCellEditor.Ed;

    public void testEditNode() throws Exception {

        Children.Array kids = new Children.Array();

        Node[] n = new Node[20];

        Node node = null;

        for (int i=0; i < n.length; i++) {

            n[i] = new RenamableNode ("" + i);

            if (i == 5) {

                node = n[i]; //pick one to edit

            }

        }

        kids.add(n);

        final Node root = new AbstractNode (kids);

        root.setDisplayName("Root");

        final WL wl = new WL();

        final F[] ff = new F[1];

        EventQueue.invokeLater(new Runnable() {

            @Override

            public void run() {

                ff[0] = new F(root);

                ff[0].addWindowListener(wl);

                ff[0].pack();

                ff[0].setVisible(true);

            }

        });

        wl.latch.await();

        F f = ff[0];

        //sanity check

        assertTrue (f.isDisplayable());

        assertTrue (f.isShowing());

        assertTrue (f.view.isShowing());

        JTree tree = f.view.tree;

        TreeViewCellEditor ce = (TreeViewCellEditor) tree.getCellEditor();

        Ed ed = ce.ed();

        final JTextField comp = ed.comp();

        final CountDownLatch latch = new CountDownLatch(1);

        comp.addHierarchyListener(new HierarchyListener() {

            @Override

            public void hierarchyChanged(HierarchyEvent e) {

                if (comp.isDisplayable()) {

                    latch.countDown();

                }

            }

        });

        f.view.editNode(node);

        latch.await();

        assertTrue (tree.isEditing());

        assertTrue (comp.isDisplayable());

        f.setVisible(false);

        f.dispose();

    }

    private static final class RenamableNode extends AbstractNode {

        RenamableNode (String name) {

            super (Children.LEAF);

            setDisplayName(name);

            setName (name);

        }

        @Override

        public boolean canRename() {

            return true;

        }

    }

    private static final class F extends JFrame implements ExplorerManager.Provider {

        private final ExplorerManager mgr = new ExplorerManager();

        private final BeanTreeView view = new BeanTreeView();

        F(Node root) {

            setContentPane(view);

            mgr.setRootContext(root);

        }

        @Override

        public ExplorerManager getExplorerManager() {

            return mgr;

        }

    }

    private static final class WL extends WindowAdapter {

        CountDownLatch latch = new CountDownLatch(1);

        @Override

        public void windowOpened(WindowEvent e) {

            super.windowOpened(e);

            latch.countDown();

        }

    }