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

441 lines
20 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 TableModelEvent">Class TableModelEvent</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.TableModelEvent</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">TableModelEvent</span>
extends <a href="../../../java/util/EventObject.html" title="class in java.util">EventObject</a></pre>
<div class="block">
<span>TableModelEvent用于通知侦听器表模型已更改。</span>
<span>模型事件描述对TableModel的更改并且对行和列的所有引用都位于模型的坐标系统中。</span>
<span>根据构造函数中使用的参数TableModelevent可用于指定以下类型的更改</span>
<pre> <span>TableModelEvent(source); // The data, ie. all rows changed
TableModelEvent(source, HEADER_ROW); // Structure change, reallocate TableColumns
TableModelEvent(source, 1); // Row 1 changed
TableModelEvent(source, 3, 6); // Rows 3 to 6 inclusive changed
TableModelEvent(source, 2, 2, 6); // Cell at (2, 6) changed
TableModelEvent(source, 3, 6, ALL_COLUMNS, INSERT); // Rows (3, 6) were inserted
TableModelEvent(source, 3, 6, ALL_COLUMNS, DELETE); // Rows (3, 6) were deleted</span> </pre>
<span>可以使用参数的其他组合,并不是全部都是有意义的。</span>
<span>通过子类化您可以添加其他信息例如事件是否发生或DID发生。</span>
<span>这使得DELETE事件中的行的规范更有用但是没有包含在swing包中因为JTable只需要事件后通知。</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/table/TableModel.html" title="javax.swing.table中的接口"><code>TableModel</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>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#ALL_COLUMNS">ALL_COLUMNS</a></span></code>
<div class="block">
指定一行或多行中的所有列。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#column">column</a></span></code> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#DELETE">DELETE</a></span></code>
<div class="block">
标识删除行或列。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#firstRow">firstRow</a></span></code> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#HEADER_ROW">HEADER_ROW</a></span></code>
<div class="block">
标识标题行。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#INSERT">INSERT</a></span></code>
<div class="block">
标识新行或列的添加。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#lastRow">lastRow</a></span></code> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#type">type</a></span></code> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#UPDATE">UPDATE</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/TableModelEvent.html#TableModelEvent-javax.swing.table.TableModel-">TableModelEvent</a></span>(<a href="../../../javax/swing/table/TableModel.html" title="interface in javax.swing.table">TableModel</a> source)</code>
<div class="block">
表中的所有行数据已更改,侦听器应丢弃基于行的任何状态,并重新查询
<code>TableModel</code>以获取新行计数和所有适当的值。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#TableModelEvent-javax.swing.table.TableModel-int-">TableModelEvent</a></span>(<a href="../../../javax/swing/table/TableModel.html" title="interface in javax.swing.table">TableModel</a> source, int row)</code>
<div class="block">
此行数据已更新。
</div> </td>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#TableModelEvent-javax.swing.table.TableModel-int-int-">TableModelEvent</a></span>(<a href="../../../javax/swing/table/TableModel.html" title="interface in javax.swing.table">TableModel</a> source, int firstRow, int lastRow)</code>
<div class="block">
行[
<i>firstRow</i>
<i>lastRow</i> ]中的数据已更新。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#TableModelEvent-javax.swing.table.TableModel-int-int-int-">TableModelEvent</a></span>(<a href="../../../javax/swing/table/TableModel.html" title="interface in javax.swing.table">TableModel</a> source, int firstRow, int lastRow, int column)</code>
<div class="block">
范围[
<i>firstRow</i>
<i>lastRow</i> ]中列
<i></i>中的单元格已更新。
</div> </td>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#TableModelEvent-javax.swing.table.TableModel-int-int-int-int-">TableModelEvent</a></span>(<a href="../../../javax/swing/table/TableModel.html" title="interface in javax.swing.table">TableModel</a> source, int firstRow, int lastRow, int column, int type)</code>
<div class="block">
firstRowcolumnlastRowcolumn的单元格已更改。
</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>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#getColumn--">getColumn</a></span>()</code>
<div class="block">
返回事件的列。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#getFirstRow--">getFirstRow</a></span>()</code>
<div class="block">
返回更改的第一行。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#getLastRow--">getLastRow</a></span>()</code>
<div class="block">
返回更改的最后一行。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/event/TableModelEvent.html#getType--">getType</a></span>()</code>
<div class="block">
返回事件的类型 - 其中之一INSERTUPDATE和DELETE。
</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="INSERT">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>INSERT</h4> <pre>public static final int INSERT</pre>
<div class="block">
标识新行或列的添加。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.swing.event.TableModelEvent.INSERT">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="UPDATE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>UPDATE</h4> <pre>public static final int UPDATE</pre>
<div class="block">
标识对现有数据的更改。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.swing.event.TableModelEvent.UPDATE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="DELETE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>DELETE</h4> <pre>public static final int DELETE</pre>
<div class="block">
标识删除行或列。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.swing.event.TableModelEvent.DELETE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="HEADER_ROW">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>HEADER_ROW</h4> <pre>public static final int HEADER_ROW</pre>
<div class="block">
标识标题行。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.swing.event.TableModelEvent.HEADER_ROW">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="ALL_COLUMNS">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ALL_COLUMNS</h4> <pre>public static final int ALL_COLUMNS</pre>
<div class="block">
指定一行或多行中的所有列。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.swing.event.TableModelEvent.ALL_COLUMNS">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="type">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>type</h4> <pre>protected int type</pre> </li>
</ul> <a name="firstRow">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>firstRow</h4> <pre>protected int firstRow</pre> </li>
</ul> <a name="lastRow">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>lastRow</h4> <pre>protected int lastRow</pre> </li>
</ul> <a name="column">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>column</h4> <pre>protected int column</pre> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="TableModelEvent-javax.swing.table.TableModel-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>TableModelEvent</h4> <pre>public TableModelEvent(<a href="../../../javax/swing/table/TableModel.html" title="interface in javax.swing.table">TableModel</a> source)</pre>
<div class="block">
<span>表中的所有行数据已更改,侦听器应丢弃基于行的任何状态,并重新查询<code>TableModel</code>以获取新的行数和所有适当的值。</span>
<span><code>JTable</code>将在收到此事件时重新绘制整个可视区域,并向模型查询可见的单元格值。</span>
<span>表的结构,即列名,类型和顺序没有改变。</span>
</div> </li>
</ul> <a name="TableModelEvent-javax.swing.table.TableModel-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>TableModelEvent</h4> <pre>public TableModelEvent(<a href="../../../javax/swing/table/TableModel.html" title="interface in javax.swing.table">TableModel</a> source,
int row)</pre>
<div class="block">
<span>此行数据已更新。</span>
<span>为了表示一个完全新的表中的具有不同结构的到达使用<code>HEADER_ROW</code>作为值<code>row</code></span>
<span><code>JTable</code>收到此事件并设置其<code>autoCreateColumnsFromModel</code>标志时它会丢弃它所拥有的任何TableColumn并按照它们在模型中显示的顺序重新分配默认值。</span>
<span>这与<code>setModel(TableModel)</code>上的<code>JTable</code></span>
</div> </li>
</ul> <a name="TableModelEvent-javax.swing.table.TableModel-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>TableModelEvent</h4> <pre>public TableModelEvent(<a href="../../../javax/swing/table/TableModel.html" title="interface in javax.swing.table">TableModel</a> source,
int firstRow,
int lastRow)</pre>
<div class="block">
行[
<i>firstRow</i>
<i>lastRow</i> ]中的数据已更新。
</div> </li>
</ul> <a name="TableModelEvent-javax.swing.table.TableModel-int-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>TableModelEvent</h4> <pre>public TableModelEvent(<a href="../../../javax/swing/table/TableModel.html" title="interface in javax.swing.table">TableModel</a> source,
int firstRow,
int lastRow,
int column)</pre>
<div class="block">
范围[
<i>firstRow</i>
<i>lastRow</i> ]中列
<i></i>中的单元格已更新。
</div> </li>
</ul> <a name="TableModelEvent-javax.swing.table.TableModel-int-int-int-int-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>TableModelEvent</h4> <pre>public TableModelEvent(<a href="../../../javax/swing/table/TableModel.html" title="interface in javax.swing.table">TableModel</a> source,
int firstRow,
int lastRow,
int column,
int type)</pre>
<div class="block">
<span>firstRowcolumnlastRowcolumn的单元格已更改。</span>
<span><i></i>是指模型坐标系中单元格的列索引。</span>
<span><i>列为</i> ALL_COLUMNS时指定行范围内的所有单元格都将被更改。</span>
<p> <span><i>类型</i>应该是INSERTUPDATE和DELETE之一。</span> </p>
</div> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getFirstRow--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getFirstRow</h4> <pre>public int getFirstRow()</pre>
<div class="block">
<span>返回更改的第一行。</span>
<span>HEADER_ROW表示元数据</span>
<span>列的名称,类型和顺序。</span>
</div> </li>
</ul> <a name="getLastRow--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLastRow</h4> <pre>public int getLastRow()</pre>
<div class="block">
返回更改的最后一行。
</div> </li>
</ul> <a name="getColumn--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getColumn</h4> <pre>public int getColumn()</pre>
<div class="block">
<span>返回事件的列。</span>
<span>如果返回值为ALL_COLUMNS;</span>
<span>这意味着指定行中的每一列都被更改。</span>
</div> </li>
</ul> <a name="getType--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getType</h4> <pre>public int getType()</pre>
<div class="block">
返回事件的类型 - 其中之一INSERTUPDATE和DELETE。
</div> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>