The Java Tutorials have been written for JDK 8.Java教程是为JDK 8编写的。Examples and practices described in this page don't take advantage of improvements introduced in later releases and might use technology no longer available.本页中描述的示例和实践没有利用后续版本中引入的改进,并且可能使用不再可用的技术。See Java Language Changes for a summary of updated language features in Java SE 9 and subsequent releases.有关Java SE 9及其后续版本中更新的语言特性的摘要,请参阅Java语言更改。
See JDK Release Notes for information about new features, enhancements, and removed or deprecated options for all JDK releases.有关所有JDK版本的新功能、增强功能以及已删除或不推荐的选项的信息,请参阅JDK发行说明。
Sometimes when using a tree, you might need to react when a branch becomes expanded or collapsed. For example, you might need to load or save data.
Two kinds of listeners report expansion and collapse occurrences: tree expansion listeners and tree-will-expand listeners. This page discusses tree expansion listeners. See How to Write a Tree-Will-Expand Listener for a description of Tree-Will-Expand listeners.
A tree expansion listener detects when an expansion or collapse has already occurred. In general, you should implement a tree expansion listener unless you need to prevent an expansion or collapse from occurring .
This example demonstrates a simple tree expansion listener. The text area at the bottom of the window displays a message every time a tree expansion event occurs. It's a straightforward, simple demo. To see a more interesting version that can veto expansions, see How to Write a Tree-Will-Expand Listener.
The following code shows how the program handles expansion events. You can find the source code for this example in TreeExpandEventDemo.java
.
public class TreeExpandEventDemo ... { ... void saySomething(String eventDescription, TreeExpansionEvent e) { textArea.append(eventDescription + "; " + "path = " + e.getPath() + newline); } class DemoArea ... implements TreeExpansionListener { ... public DemoArea() { ... tree.addTreeExpansionListener(this); ... } ... // Required by TreeExpansionListener interface. public void treeExpanded(TreeExpansionEvent e) { saySomething("Tree-expanded event detected", e); } // Required by TreeExpansionListener interface. public void treeCollapsed(TreeExpansionEvent e) { saySomething("Tree-collapsed event detected", e); } } }
The TreeExpansionListener Interface
TreeExpansionListener
has no adapter class.
Method | Purpose |
---|---|
treeCollapsed(TreeExpansionEvent) | Called just after a tree node collapses. |
treeExpanded(TreeExpansionEvent) | Called just after a tree node expands. |
Method | Purpose |
---|---|
Object getSource() | Return the object that fired the event. |
TreePath getPath() | Returns a TreePath object that identifies each node from the root of the tree to the collapsed/expanded node, inclusive. |
The following table lists the examples that use tree expansion listeners.
Example | Where Described | Notes |
---|---|---|
TreeExpandEventDemo |
This section | Displays a message whenever a tree expansion event occurs. |
TreeExpandEventDemo2 |
How to Write a Tree-Will-Expand Listener | Adds a tree-will-expand listener to TreeExpandEventDemo . |