Explorer & Property Sheet API
Official

See:
Description

Explorer & Property Sheet API

org.openide.explorer	Many different UI components in NetBeans are actually Explorer views of nodes.
org.openide.explorer.propertysheet	The exact properties of a node may be displayed and edited with the Property Sheet.
org.openide.explorer.propertysheet.editors
org.openide.explorer.view	The Explorer is really an abstraction that needs a view to actually display the nodes.

XXX no answer for arch-overall

What is New (see all changes)?

• Jan 11 '10 OutlineView.setPropertyColumns, OutlineView.addPropertyColumn and OutlineView.removePropertyColumn added.

  Added methods to manipulate the displayed columns of an OutlineView without needing to create prototype property objects, both making it simpler to use, and avoiding the common problem of properties not appearing because the prototype property does not use the exact type required.

  Deprecated OutlineView.setProperties(), as this was only needed for ease of replacement of TreeTableView.

• Dec 21 '09 OutlineView.setTreeSortable added.

  Added method to set or unset the tree column as sortable.

• Oct 19 '09 TreeView.setAutoWaitCursor added.

  Added method to control automatic setting of wait cursor when node is expanded.

• Mar 8 '09 Support for check-boxes displayed next to node icons.

  Nodes can have check-boxes rendered next to their icons or display names.

• Sep 16 '08 setSelectedNodes() does partial selection instead of throwing IllegalArgumentException when some of newly selected nodes are not under root context.

  Nodes can be removed outside of AWT thread while e.g. view can try to select them. This generated IllegalArgumentException during checking if such a node is under root context. Now setSelectedNodes(). does partial selection of valid nodes instead of throwing IllegalArgumentException.

Use Cases

XXX no answer for arch-usecases

Exported Interfaces

This table lists all of the module exported APIs with defined stability classifications. It is generated based on answers to questions about the architecture of the module. Read them all...

Group of java interfaces

Interface Name	In/Out	Stability	Specified in What Document?
ExplorerAPI	Exported	Official	.../org/openide/explorer/doc-files/api.html
TreeTableViewSortingAPI	Exported	Friend

Group of property interfaces

Interface Name	In/Out	Stability	Specified in What Document?
org.openide.explorer.VisualizerNode.prefetchCount	Exported	Private	Setting this property to integer number controls prefetching of nodes when VisualizerChildren are constructed (prefetchCount = 0 disables prefetching). The prefetching should eliminate "bounce" effect (see #144718) in lazy implementation which is caused by the fact that there exist keys without nodes. In such case "dummy" nodes are created and remove event is fired. This undesirable effect is eliminated by prefetching selected number of nodes so "dummy" nodes are detected and removed in advance before any visualization occurs.
netbeans.dnd.enabled	Exported	Private	Checks by Drag & Drop support for views. True is regard as default (no matter what jdk's version). False value disallows Drag & Drop in all views.
customDelete	Exported	Under Development	Nodes returing Boolean.TRUE from getValue("customDelete") are assumed to provide their own confirmation dialog for delete action and explorer will not show default one when they are deleted.

Implementation Details

Where are the sources for the module?

The sources for the module are in the NetBeans Mercurial repositories.

What do other modules need to do to declare a dependency on this one, in addition to or instead of a plain module dependency?

XXX no answer for deploy-dependencies

Read more about the implementation in the answers to architecture questions.