uTools-Manuals/docs/java/javax/swing/CellEditor.html

259 lines
12 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
</div>
<h2 class="title" title="Interface CellEditor">Interface CellEditor</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Known Subinterfaces:
</dt>
<dd>
<span><a href="../../javax/swing/table/TableCellEditor.html" title="javax.swing.table中的接口">TableCellEditor</a> <a href="../../javax/swing/tree/TreeCellEditor.html" title="javax.swing.tree中的接口">TreeCellEditor</a></span>
</dd>
</dl>
<dl>
<dt>
所有已知实现类:
</dt>
<dd>
<span><a href="../../javax/swing/AbstractCellEditor.html" title="javax.swing中的类">AbstractCellEditor</a> <a href="../../javax/swing/DefaultCellEditor.html" title="javax.swing中的类">DefaultCellEditor</a> <a href="../../javax/swing/tree/DefaultTreeCellEditor.html" title="javax.swing.tree中的类">DefaultTreeCellEditor</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">CellEditor</span></pre>
<div class="block">
<span>该界面定义了一般编辑器应该能够实现的方法。</span>
<p> <span>使用此接口可以使复杂的组件(编辑器的客户端)(如<code>JTree</code><code>JTable</code>允许任何通用编辑器编辑表单元格或树单元格等中的值。没有此通用编辑器界面, <code>JTable</code>将不得不知道具体的编辑器,如<code>JTextField</code> <code>JCheckBox</code> <code>JComboBox</code> ,等等。此外,如果没有这个接口,编辑如客户<code>JTable</code>将无法由用户或第三方ISV将来开发的任何编辑工作。</span> </p>
<p> <span>要使用此界面,创建新编辑器的开发人员可以使新组件实现该接口。</span> <span>或者开发人员可以选择的包装为基础的方法,并提供一个实现了一个同伴对象<code>CellEditor</code>接口(见<code>JCellEditor</code>为例)。</span> <span>如果用户希望使用第三方ISV编辑器的包装方法是非常有用<code>JTable</code> 但ISV没有实现<code>CellEditor</code>接口。</span> <span>用户可以简单地创建一个包含第三方编辑器对象实例的对象,并将<code>CellEditor</code> API“转换”为第三方编辑器的API。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../javax/swing/event/CellEditorListener.html" title="javax.swing.event中的接口"><code>CellEditorListener</code></a></span>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== 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="t3"><span><a href="javascript:show(4);">抽象方法</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>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/CellEditor.html#addCellEditorListener-javax.swing.event.CellEditorListener-">addCellEditorListener</a></span>(<a href="../../javax/swing/event/CellEditorListener.html" title="interface in javax.swing.event">CellEditorListener</a> l)</code>
<div class="block">
将一个监听器添加到编辑器停止时通知的列表,或者取消编辑。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/CellEditor.html#cancelCellEditing--">cancelCellEditing</a></span>()</code>
<div class="block">
告诉编辑器取消编辑,不接受任何部分编辑的值。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<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/CellEditor.html#getCellEditorValue--">getCellEditorValue</a></span>()</code>
<div class="block">
返回编辑器中包含的值。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/CellEditor.html#isCellEditable-java.util.EventObject-">isCellEditable</a></span>(<a href="../../java/util/EventObject.html" title="class in java.util">EventObject</a> anEvent)</code>
<div class="block">
要求编辑器是否可以使用
<code>anEvent</code>开始编辑。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/CellEditor.html#removeCellEditorListener-javax.swing.event.CellEditorListener-">removeCellEditorListener</a></span>(<a href="../../javax/swing/event/CellEditorListener.html" title="interface in javax.swing.event">CellEditorListener</a> l)</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/CellEditor.html#shouldSelectCell-java.util.EventObject-">shouldSelectCell</a></span>(<a href="../../java/util/EventObject.html" title="class in java.util">EventObject</a> anEvent)</code>
<div class="block">
如果选择编辑单元格则返回true否则返回false。
</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/CellEditor.html#stopCellEditing--">stopCellEditing</a></span>()</code>
<div class="block">
告诉编辑器停止编辑并接受任何部分编辑的值作为编辑器的值。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getCellEditorValue--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCellEditorValue</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> getCellEditorValue()</pre>
<div class="block">
返回编辑器中包含的值。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
编辑器中包含的值
</dd>
</dl> </li>
</ul> <a name="isCellEditable-java.util.EventObject-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isCellEditable</h4> <pre>boolean isCellEditable(<a href="../../java/util/EventObject.html" title="class in java.util">EventObject</a> anEvent)</pre>
<div class="block">
<span>要求编辑器是否可以使用<code>anEvent</code>开始编辑。</span>
<span><code>anEvent</code>在调用组件坐标系中。</span>
<span>编辑器不能假定由返回的Component <code>getCellEditorComponent</code>安装。</span>
<span>这种方法是为了使用客户端避免在不可能编辑的情况下设置和安装编辑器组件的成本。</span>
<span>如果可以开始编辑则此方法返回true。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>anEvent</code> - 编辑器应该使用的事件来考虑是否开始编辑
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果可以开始编辑则为true
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/CellEditor.html#shouldSelectCell-java.util.EventObject-"><code>shouldSelectCell(java.util.EventObject)</code></a>
</dd>
</dl> </li>
</ul> <a name="shouldSelectCell-java.util.EventObject-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>shouldSelectCell</h4> <pre>boolean shouldSelectCell(<a href="../../java/util/EventObject.html" title="class in java.util">EventObject</a> anEvent)</pre>
<div class="block">
<span>如果选择编辑单元格则返回true否则返回false。</span>
<span>通常返回值为true因为大多数情况下应该选择编辑单元格。</span>
<span>但是返回false是有用的以保持选择不会对某些类型的编辑进行更改。</span>
<span>例如。</span>
<span>包含一列复选框的表格,用户可能希望能够更改这些复选框,而无需更改选择。</span>
<span>参见Netscape Communicator只是这样一个例子当然由编辑器的客户端使用返回值但不需要如果它不想。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>anEvent</code> - 编辑器应该用来开始编辑的事件
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>如果编辑器希望选择编辑单元则为true;</span>
<span>否则返回false</span>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/CellEditor.html#isCellEditable-java.util.EventObject-"><code>isCellEditable(java.util.EventObject)</code></a>
</dd>
</dl> </li>
</ul> <a name="stopCellEditing--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>stopCellEditing</h4> <pre>boolean stopCellEditing()</pre>
<div class="block">
<span>告诉编辑器停止编辑并接受任何部分编辑的值作为编辑器的值。</span>
<span>如果编辑没有停止编辑器返回false;</span>
<span>这对于验证并且不能接受无效条目的编辑者很有用。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>如果编辑停止则为true;</span>
<span>否则为假</span>
</dd>
</dl> </li>
</ul> <a name="cancelCellEditing--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>cancelCellEditing</h4> <pre>void cancelCellEditing()</pre>
<div class="block">
告诉编辑器取消编辑,不接受任何部分编辑的值。
</div> </li>
</ul> <a name="addCellEditorListener-javax.swing.event.CellEditorListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addCellEditorListener</h4> <pre>void addCellEditorListener(<a href="../../javax/swing/event/CellEditorListener.html" title="interface in javax.swing.event">CellEditorListener</a> l)</pre>
<div class="block">
将一个监听器添加到编辑器停止时通知的列表,或者取消编辑。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>l</code> - CellEditorListener
</dd>
</dl> </li>
</ul> <a name="removeCellEditorListener-javax.swing.event.CellEditorListener-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>removeCellEditorListener</h4> <pre>void removeCellEditorListener(<a href="../../javax/swing/event/CellEditorListener.html" title="interface in javax.swing.event">CellEditorListener</a> l)</pre>
<div class="block">
从通知列表中移除侦听器
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>l</code> - CellEditorListener
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>