uTools-Manuals/docs/java/javax/swing/event/TreeSelectionEvent.html

448 lines
22 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
javax.swing.event
</div>
<h2 class="title" title="Class TreeSelectionEvent">Class TreeSelectionEvent</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../java/util/EventObject.html" title="class in java.util">java.util.EventObject</a></li>
<li>
<ul class="inheritance">
<li>javax.swing.event.TreeSelectionEvent</li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Implemented Interfaces:
</dt>
<dd>
<span><a href="../../../java/io/Serializable.html" title="java.io中的接口">Serializable</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">TreeSelectionEvent</span>
extends <a href="../../../java/util/EventObject.html" title="class in java.util">EventObject</a></pre>
<div class="block">
<span>表示当前选择的变化的事件。</span>
<span>更改基于任意数量的路径。</span>
<span>TreeSelectionListeners通常将查询每个潜在更改行的新选定状态的事件源。</span>
<p> <span><strong>警告:</strong>此类的序列化对象与将来的Swing版本不兼容。</span> <span>当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。</span> <span>从1.4开始对所有JavaBeans的长期存储的支持已被添加到<code>java.beans</code>包中。</span> <span>请参阅<a href="../../../java/beans/XMLEncoder.html" title="java.beans中的类"><code>XMLEncoder</code></a></span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../javax/swing/event/TreeSelectionListener.html" title="javax.swing.event中的接口"><code>TreeSelectionListener</code></a> <a href="../../../javax/swing/tree/TreeSelectionModel.html" title="javax.swing.tree中的接口"><code>TreeSelectionModel</code></a></span>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
<caption>
<span>Fields</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected boolean[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TreeSelectionEvent.html#areNew">areNew</a></span></code>
<div class="block">
对于每个路径,标识该路径实际上是新的。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TreeSelectionEvent.html#newLeadSelectionPath">newLeadSelectionPath</a></span></code>
<div class="block">
leadSelectionPath在路径更改后可能为null。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TreeSelectionEvent.html#oldLeadSelectionPath">oldLeadSelectionPath</a></span></code>
<div class="block">
leadSelectionPath在路径更改之前可能为null。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TreeSelectionEvent.html#paths">paths</a></span></code>
<div class="block">
此事件代表的路径。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.java.util.EventObject">
<!-- --> </a> <h3>Fields inherited from class java.util.<a href="../../../java/util/EventObject.html" title="class in java.util">EventObject</a></h3> <code><a href="../../../java/util/EventObject.html#source">source</a></code></li>
</ul> </li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TreeSelectionEvent.html#TreeSelectionEvent-java.lang.Object-javax.swing.tree.TreePath:A-boolean:A-javax.swing.tree.TreePath-javax.swing.tree.TreePath-">TreeSelectionEvent</a></span>(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> source, <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a>[] paths, boolean[] areNew, <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> oldLeadSelectionPath, <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> newLeadSelectionPath)</code>
<div class="block">
表示对TreeSelectionModel选择的更改。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TreeSelectionEvent.html#TreeSelectionEvent-java.lang.Object-javax.swing.tree.TreePath-boolean-javax.swing.tree.TreePath-javax.swing.tree.TreePath-">TreeSelectionEvent</a></span>(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> source, <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> path, boolean isNew, <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> oldLeadSelectionPath, <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> newLeadSelectionPath)</code>
<div class="block">
表示对TreeSelectionModel选择的更改。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t4"><span><a href="javascript:show(8);">具体的方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TreeSelectionEvent.html#cloneWithSource-java.lang.Object-">cloneWithSource</a></span>(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> newSource)</code>
<div class="block">
返回接收者的副本但源代码是newSource。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TreeSelectionEvent.html#getNewLeadSelectionPath--">getNewLeadSelectionPath</a></span>()</code>
<div class="block">
返回当前引导路径。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TreeSelectionEvent.html#getOldLeadSelectionPath--">getOldLeadSelectionPath</a></span>()</code>
<div class="block">
返回先前是引导路径的路径。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TreeSelectionEvent.html#getPath--">getPath</a></span>()</code>
<div class="block">
返回第一个路径元素。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TreeSelectionEvent.html#getPaths--">getPaths</a></span>()</code>
<div class="block">
返回从选择中添加或删除的路径。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TreeSelectionEvent.html#isAddedPath--">isAddedPath</a></span>()</code>
<div class="block">
返回由确定的路径是否
<code>getPath</code>加入到选择。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TreeSelectionEvent.html#isAddedPath-int-">isAddedPath</a></span>(int index)</code>
<div class="block">
返回是否将
<code>getPaths()[index]</code>的路径添加到选择。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TreeSelectionEvent.html#isAddedPath-javax.swing.tree.TreePath-">isAddedPath</a></span>(<a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> path)</code>
<div class="block">
返回指定的路径是否添加到选择。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.util.EventObject">
<!-- --> </a> <h3>Methods inherited from class java.util.<a href="../../../java/util/EventObject.html" title="class in java.util">EventObject</a></h3> <code><a href="../../../java/util/EventObject.html#getSource--">getSource</a>, <a href="../../../java/util/EventObject.html#toString--">toString</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../java/lang/Object.html#clone--">clone</a>, <a href="../../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- --> </a> <h3>字段详细信息</h3> <a name="paths">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>paths</h4> <pre>protected <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a>[] paths</pre>
<div class="block">
此事件代表的路径。
</div> </li>
</ul> <a name="areNew">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>areNew</h4> <pre>protected boolean[] areNew</pre>
<div class="block">
对于每个路径,标识该路径实际上是新的。
</div> </li>
</ul> <a name="oldLeadSelectionPath">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>oldLeadSelectionPath</h4> <pre>protected <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> oldLeadSelectionPath</pre>
<div class="block">
leadSelectionPath在路径更改之前可能为null。
</div> </li>
</ul> <a name="newLeadSelectionPath">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>newLeadSelectionPath</h4> <pre>protected <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> newLeadSelectionPath</pre>
<div class="block">
leadSelectionPath在路径更改后可能为null。
</div> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="TreeSelectionEvent-java.lang.Object-javax.swing.tree.TreePath:A-boolean:A-javax.swing.tree.TreePath-javax.swing.tree.TreePath-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>TreeSelectionEvent</h4> <pre>public TreeSelectionEvent(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> source,
<a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a>[] paths,
boolean[] areNew,
<a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> oldLeadSelectionPath,
<a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> newLeadSelectionPath)</pre>
<div class="block">
<span>表示对TreeSelectionModel选择的更改。</span>
<span>路径标识已经从选择中添加或删除的路径。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>source</code> - 事件来源
</dd>
<dd>
<code>paths</code> - 选择中已更改的路径
</dd>
</dl> </li>
</ul> <a name="TreeSelectionEvent-java.lang.Object-javax.swing.tree.TreePath-boolean-javax.swing.tree.TreePath-javax.swing.tree.TreePath-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>TreeSelectionEvent</h4> <pre>public TreeSelectionEvent(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> source,
<a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> path,
boolean isNew,
<a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> oldLeadSelectionPath,
<a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> newLeadSelectionPath)</pre>
<div class="block">
<span>表示对TreeSelectionModel选择的更改。</span>
<span>路径标识已经从选择中添加或删除的路径。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>source</code> - 事件来源
</dd>
<dd>
<code>path</code> - 选择中已更改的路径
</dd>
<dd>
<code>isNew</code> - 路径是否为选择的新路径false表示从选择中删除路径。
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getPaths--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPaths</h4> <pre>public <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a>[] getPaths()</pre>
<div class="block">
返回从选择中添加或删除的路径。
</div> </li>
</ul> <a name="getPath--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPath</h4> <pre>public <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> getPath()</pre>
<div class="block">
返回第一个路径元素。
</div> </li>
</ul> <a name="isAddedPath--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isAddedPath</h4> <pre>public boolean isAddedPath()</pre>
<div class="block">
<span>返回由<code>getPath</code>的路径是否添加到选择。</span>
<span>的返回值<code>true</code>表示由标识的路径<code>getPath</code>加入到该选择。</span>
<span>返回值为<code>false</code>表示<code>getPath</code>选择,但不再选择。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果
<code>getPath</code>被添加到选择,
<code>false</code>否则
</dd>
</dl> </li>
</ul> <a name="isAddedPath-javax.swing.tree.TreePath-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isAddedPath</h4> <pre>public boolean isAddedPath(<a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> path)</pre>
<div class="block">
<span>返回指定的路径是否添加到选择。</span>
<span>的返回值<code>true</code>表示由标识的路径<code>path</code>加入到该选择。</span>
<span>返回值为<code>false</code>表示<code>path</code>不再被选中。</span>
<span>此方法仅适用于从<code>getPaths()</code>返回的路径;</span>
<span>调用一个没有包含在<code>getPaths()</code>的路径抛出一个<code>IllegalArgumentException</code></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>path</code> - 测试的路径
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果
<code>path</code>被添加到选择,
<code>false</code>否则
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>path</code>不包含在
<code>getPaths</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/swing/event/TreeSelectionEvent.html#getPaths--"><code>getPaths()</code></a>
</dd>
</dl> </li>
</ul> <a name="isAddedPath-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isAddedPath</h4> <pre>public boolean isAddedPath(int index)</pre>
<div class="block">
<span>返回<code>getPaths()[index]</code>的路径是否添加到选择。</span>
<span>返回值为<code>true</code>表示路径被添加到选择。</span>
<span>返回值为<code>false</code>表示不再选择路径。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>index</code> - 测试路径的索引
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果路径被添加到选择,
<code>false</code> false
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果索引超出了
<code>getPaths</code>的范围
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.3
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/swing/event/TreeSelectionEvent.html#getPaths--"><code>getPaths()</code></a>
</dd>
</dl> </li>
</ul> <a name="getOldLeadSelectionPath--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getOldLeadSelectionPath</h4> <pre>public <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> getOldLeadSelectionPath()</pre>
<div class="block">
返回先前是引导路径的路径。
</div> </li>
</ul> <a name="getNewLeadSelectionPath--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getNewLeadSelectionPath</h4> <pre>public <a href="../../../javax/swing/tree/TreePath.html" title="class in javax.swing.tree">TreePath</a> getNewLeadSelectionPath()</pre>
<div class="block">
返回当前引导路径。
</div> </li>
</ul> <a name="cloneWithSource-java.lang.Object-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>cloneWithSource</h4> <pre>public <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> cloneWithSource(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> newSource)</pre>
<div class="block">
返回接收者的副本但源代码是newSource。
</div> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>