uTools-Manuals/docs/java/javax/swing/text/StringContent.html

484 lines
21 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.text
</div>
<h2 class="title" title="Class StringContent">Class StringContent</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>javax.swing.text.StringContent</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> <a href="../../../javax/swing/text/AbstractDocument.Content.html" title="javax.swing.text中的接口">AbstractDocument.Content</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public final class <span class="typeNameLabel">StringContent</span>
extends <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a>
implements <a href="../../../javax/swing/text/AbstractDocument.Content.html" title="interface in javax.swing.text">AbstractDocument.Content</a>, <a href="../../../java/io/Serializable.html" title="interface in java.io">Serializable</a></pre>
<div class="block">
<span>AbstractDocument.Content接口的实现是一种强大的强制实现对于较小的文档和/或调试很有用。</span>
<span>它将字符内容管理为一个简单的字符数组。</span>
<span>这也是相当低效的。</span>
<p> <span>通常建议使用间隙缓冲区或片表实现。</span> <span>该缓冲区不会扩展到大尺寸。</span> </p>
<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> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== 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/text/StringContent.html#StringContent--">StringContent</a></span>()</code>
<div class="block">
创建一个新的StringContent对象。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/swing/text/StringContent.html#StringContent-int-">StringContent</a></span>(int initialLength)</code>
<div class="block">
创建一个新的StringContent对象并指定初始大小。
</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="../../../javax/swing/text/Position.html" title="interface in javax.swing.text">Position</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/text/StringContent.html#createPosition-int-">createPosition</a></span>(int offset)</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/text/StringContent.html#getChars-int-int-javax.swing.text.Segment-">getChars</a></span>(int where, int len, <a href="../../../javax/swing/text/Segment.html" title="class in javax.swing.text">Segment</a> chars)</code>
<div class="block">
检索一部分内容。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>protected <a href="../../../java/util/Vector.html" title="class in java.util">Vector</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/text/StringContent.html#getPositionsInRange-java.util.Vector-int-int-">getPositionsInRange</a></span>(<a href="../../../java/util/Vector.html" title="class in java.util">Vector</a> v, int offset, int length)</code>
<div class="block">
返回一个Vector其中包含UndoPosRef的实例其位置范围为
<code>offset</code>
<code>offset</code> +
<code>length</code>
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/text/StringContent.html#getString-int-int-">getString</a></span>(int where, int len)</code>
<div class="block">
检索一部分内容。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../javax/swing/undo/UndoableEdit.html" title="interface in javax.swing.undo">UndoableEdit</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/text/StringContent.html#insertString-int-java.lang.String-">insertString</a></span>(int where, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> str)</code>
<div class="block">
在内容中插入一个字符串。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/text/StringContent.html#length--">length</a></span>()</code>
<div class="block">
返回内容的长度。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../../javax/swing/undo/UndoableEdit.html" title="interface in javax.swing.undo">UndoableEdit</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/text/StringContent.html#remove-int-int-">remove</a></span>(int where, int nitems)</code>
<div class="block">
删除部分内容。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/swing/text/StringContent.html#updateUndoPositions-java.util.Vector-">updateUndoPositions</a></span>(<a href="../../../java/util/Vector.html" title="class in java.util">Vector</a> positions)</code>
<div class="block">
重置positions中所有UndoPosRef实例的
<code>positions</code>
</div> </td>
</tr>
</tbody>
</table>
<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#toString--">toString</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">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="StringContent--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>StringContent</h4> <pre>public StringContent()</pre>
<div class="block">
<span>创建一个新的StringContent对象。</span>
<span>初始大小默认为10。</span>
</div> </li>
</ul> <a name="StringContent-int-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>StringContent</h4> <pre>public StringContent(int initialLength)</pre>
<div class="block">
<span>创建一个新的StringContent对象并指定初始大小。</span>
<span>如果长度&lt;1则使用1的大小。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>initialLength</code> - 初始尺寸
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="length--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>length</h4> <pre>public int length()</pre>
<div class="block">
返回内容的长度。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/swing/text/AbstractDocument.Content.html#length--">length</a></code>在界面
<code><a href="../../../javax/swing/text/AbstractDocument.Content.html" title="interface in javax.swing.text">AbstractDocument.Content</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
长度&gt; = 1
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/swing/text/AbstractDocument.Content.html#length--"><code>AbstractDocument.Content.length()</code></a>
</dd>
</dl> </li>
</ul> <a name="insertString-int-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>insertString</h4> <pre>public <a href="../../../javax/swing/undo/UndoableEdit.html" title="interface in javax.swing.undo">UndoableEdit</a> insertString(int where,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> str)
throws <a href="../../../javax/swing/text/BadLocationException.html" title="class in javax.swing.text">BadLocationException</a></pre>
<div class="block">
在内容中插入一个字符串。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/swing/text/AbstractDocument.Content.html#insertString-int-java.lang.String-">insertString</a></code>在界面
<code><a href="../../../javax/swing/text/AbstractDocument.Content.html" title="interface in javax.swing.text">AbstractDocument.Content</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>where</code> - 起始位置&gt; = 0 &amp;&amp; &lt;length
</dd>
<dd>
<code>str</code> - 要插入的非空字符串
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
用于撤消的UndoableEdit对象
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/swing/text/BadLocationException.html" title="class in javax.swing.text">BadLocationException</a></code> - 如果指定的位置无效
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/swing/text/AbstractDocument.Content.html#insertString-int-java.lang.String-"><code>AbstractDocument.Content.insertString(int, java.lang.String)</code></a>
</dd>
</dl> </li>
</ul> <a name="remove-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>remove</h4> <pre>public <a href="../../../javax/swing/undo/UndoableEdit.html" title="interface in javax.swing.undo">UndoableEdit</a> remove(int where,
int nitems)
throws <a href="../../../javax/swing/text/BadLocationException.html" title="class in javax.swing.text">BadLocationException</a></pre>
<div class="block">
<span>删除部分内容。</span>
<span>其中+ nitem必须是&lt;length</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/swing/text/AbstractDocument.Content.html#remove-int-int-">remove</a></code>在界面
<code><a href="../../../javax/swing/text/AbstractDocument.Content.html" title="interface in javax.swing.text">AbstractDocument.Content</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>where</code> - 起始位置&gt; = 0
</dd>
<dd>
<code>nitems</code> - 要删除的字符数&gt; = 0
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
用于撤消的UndoableEdit对象
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/swing/text/BadLocationException.html" title="class in javax.swing.text">BadLocationException</a></code> - 如果指定的位置无效
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/swing/text/AbstractDocument.Content.html#remove-int-int-"><code>AbstractDocument.Content.remove(int, int)</code></a>
</dd>
</dl> </li>
</ul> <a name="getString-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getString</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getString(int where,
int len)
throws <a href="../../../javax/swing/text/BadLocationException.html" title="class in javax.swing.text">BadLocationException</a></pre>
<div class="block">
<span>检索一部分内容。</span>
<span>其中+ len必须是&lt;= length</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/swing/text/AbstractDocument.Content.html#getString-int-int-">getString</a></code>在接口
<code><a href="../../../javax/swing/text/AbstractDocument.Content.html" title="interface in javax.swing.text">AbstractDocument.Content</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>where</code> - 起始位置&gt; = 0
</dd>
<dd>
<code>len</code> - 要检索的长度&gt; = 0
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>表示内容的字符串;</span>
<span>可能是空的</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/swing/text/BadLocationException.html" title="class in javax.swing.text">BadLocationException</a></code> - 如果指定的位置无效
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/swing/text/AbstractDocument.Content.html#getString-int-int-"><code>AbstractDocument.Content.getString(int, int)</code></a>
</dd>
</dl> </li>
</ul> <a name="getChars-int-int-javax.swing.text.Segment-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getChars</h4> <pre>public void getChars(int where,
int len,
<a href="../../../javax/swing/text/Segment.html" title="class in javax.swing.text">Segment</a> chars)
throws <a href="../../../javax/swing/text/BadLocationException.html" title="class in javax.swing.text">BadLocationException</a></pre>
<div class="block">
<span>检索一部分内容。</span>
<span>其中+ len必须是&lt;= length</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/swing/text/AbstractDocument.Content.html#getChars-int-int-javax.swing.text.Segment-">getChars</a></code>在界面
<code><a href="../../../javax/swing/text/AbstractDocument.Content.html" title="interface in javax.swing.text">AbstractDocument.Content</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>where</code> - 起始位置&gt; = 0
</dd>
<dd>
<code>len</code> - 要检索的字符数&gt; = 0
</dd>
<dd>
<code>chars</code> - 要返回字符的Segment对象
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/swing/text/BadLocationException.html" title="class in javax.swing.text">BadLocationException</a></code> - 如果指定的位置无效
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/swing/text/AbstractDocument.Content.html#getChars-int-int-javax.swing.text.Segment-"><code>AbstractDocument.Content.getChars(int, int, javax.swing.text.Segment)</code></a>
</dd>
</dl> </li>
</ul> <a name="createPosition-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createPosition</h4> <pre>public <a href="../../../javax/swing/text/Position.html" title="interface in javax.swing.text">Position</a> createPosition(int offset)
throws <a href="../../../javax/swing/text/BadLocationException.html" title="class in javax.swing.text">BadLocationException</a></pre>
<div class="block">
在内容中创建一个位置,该内容将随内容突变而跟踪更改。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/swing/text/AbstractDocument.Content.html#createPosition-int-">createPosition</a></code>在界面
<code><a href="../../../javax/swing/text/AbstractDocument.Content.html" title="interface in javax.swing.text">AbstractDocument.Content</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>offset</code> - 为&gt; = 0创建位置的偏移量
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
的位置
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/swing/text/BadLocationException.html" title="class in javax.swing.text">BadLocationException</a></code> - 如果指定的位置无效
</dd>
</dl> </li>
</ul> <a name="getPositionsInRange-java.util.Vector-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPositionsInRange</h4> <pre>protected <a href="../../../java/util/Vector.html" title="class in java.util">Vector</a> getPositionsInRange(<a href="../../../java/util/Vector.html" title="class in java.util">Vector</a> v,
int offset,
int length)</pre>
<div class="block">
<span>返回一个Vector其中包含UndoPosRef的实例范围为<code>offset</code><code>offset</code> + <code>length</code></span>
<span>如果<code>v</code>不为空,则匹配的位置放在那里。</span>
<span>返回带有结果位置的向量。</span>
<p> <span>这是为了内部使用,通常不是子类的兴趣。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>v</code> - 要使用的向量在null上创建一个新的
</dd>
<dd>
<code>offset</code> - 起始偏移量&gt; = 0
</dd>
<dd>
<code>length</code> - 长度&gt; = 0
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一组实例
</dd>
</dl> </li>
</ul> <a name="updateUndoPositions-java.util.Vector-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>updateUndoPositions</h4> <pre>protected void updateUndoPositions(<a href="../../../java/util/Vector.html" title="class in java.util">Vector</a> positions)</pre>
<div class="block">
<span>重置positions中所有UndoPosRef实例的<code>positions</code></span>
<p> <span>这是为了内部使用,通常不是子类的兴趣。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>positions</code> - 实例的位置
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>