Module java.desktop

Package javax.swing.text

Class StringContent

java.lang.Object

javax.swing.text.StringContent

所有已实现的接口:

Serializable, AbstractDocument.Content

       public final class StringContent extends Object implements AbstractDocument.Content, Serializable
      

一个实现了AbstractDocument.Content接口的实现，是一个粗暴的实现，适用于相对较小的文档和/或调试。它将字符内容管理为简单的字符数组。它也非常低效。

通常建议使用间隙缓冲区或片段表实现。该缓冲区不适用于大尺寸文档。

警告: 该类的序列化对象将不兼容未来的Swing版本。当前的序列化支持适用于短期存储或在运行相同Swing版本的应用程序之间的RMI。从1.4版本开始，已将所有JavaBeans的长期存储支持添加到java.beans包中。请参见XMLEncoder。

Constructor Summary

Constructors

Constructor	Description
StringContent()	创建一个新的StringContent对象。
StringContent(int initialLength)	创建一个新的StringContent对象，指定初始大小。

Method Summary

Modifier and Type	Method	Description
Position	createPosition(int offset)	创建一个在内容中跟踪更改的位置。
void	getChars(int where, int len, Segment chars)	检索内容的一部分。
protected Vector	getPositionsInRange(Vector v, int offset, int length)	返回一个包含从offset到offset + length范围内的位置的UndoPosRef实例的Vector。
String	getString(int where, int len)	检索内容的一部分。
UndoableEdit	insertString(int where, String str)	将字符串插入内容中。
int	length()	返回内容的长度。
UndoableEdit	remove(int where, int nitems)	删除内容的一部分。
protected void	updateUndoPositions(Vector positions)	重置positions中所有UndoPosRef实例的位置。

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

StringContent

             public StringContent()
            

创建一个新的StringContent对象。初始大小默认为10。

StringContent

             public StringContent(int initialLength)
            

创建一个新的StringContent对象，指定初始大小。如果长度<1，则使用1。

参数:

initialLength - 初始大小

Method Details

length

             public int length()
            

返回内容的长度。

指定者:

length 在接口 AbstractDocument.Content

返回:

长度 >= 1

参见:

• AbstractDocument.Content.length()

insertString

             public UndoableEdit insertString(int where, String str) throws BadLocationException
            

将字符串插入内容中。

指定者:

insertString 在接口 AbstractDocument.Content

参数:

where - 起始位置 >= 0 && < length()

str - 要插入的非空字符串

返回:

一个用于撤销的UndoableEdit对象

抛出:

BadLocationException - 如果指定位置无效

参见:

• AbstractDocument.Content.insertString(int, java.lang.String)

remove

             public UndoableEdit remove(int where, int nitems) throws BadLocationException
            

删除内容的一部分。where + nitems必须小于长度。

指定者:

remove 在接口 AbstractDocument.Content

参数:

where - 起始位置 >= 0

nitems - 要删除的字符数 >= 0

返回:

一个用于撤销的UndoableEdit对象

抛出:

BadLocationException - 如果指定位置无效

参见:

• AbstractDocument.Content.remove(int, int)

getString

             public String getString(int where, int len) throws BadLocationException
            

检索内容的一部分。where + len必须小于等于长度。

指定者:

getString 在接口 AbstractDocument.Content

参数:

where - 起始位置 >= 0

len - 要检索的长度 >= 0

返回:

表示内容的字符串；可能为空

抛出:

BadLocationException - 如果指定位置无效

参见:

• AbstractDocument.Content.getString(int, int)

getChars

             public void getChars(int where, int len, Segment chars) throws BadLocationException
            

检索内容的一部分。where + len必须小于等于长度。

指定者:

getChars 在接口 AbstractDocument.Content

参数:

where - 起始位置 >= 0

len - 要检索的字符数 >= 0

chars - 返回字符的Segment对象

抛出:

BadLocationException - 如果指定位置无效

参见:

• AbstractDocument.Content.getChars(int, int, javax.swing.text.Segment)

createPosition

             public Position createPosition(int offset) throws BadLocationException
            

创建一个在内容中跟踪更改的位置。

指定者:

createPosition 在接口 AbstractDocument.Content

参数:

offset - 要为其创建位置的偏移量 >= 0

返回:

位置

抛出:

BadLocationException - 如果指定位置无效

getPositionsInRange

             protected Vector getPositionsInRange(Vector v, int offset, int length)
            

返回一个包含从offset到offset + length范围内的位置的UndoPosRef实例的Vector。如果v不为null，则匹配的位置将放入其中。返回带有结果位置的向量。

这是为内部使用而设计的，通常对子类不感兴趣。

参数:

v - 要使用的Vector，在为null时创建一个新的

offset - 起始偏移量 >= 0

length - 长度 >= 0

返回:

实例集

updateUndoPositions

             protected void updateUndoPositions(Vector positions)
            

重置positions中所有UndoPosRef实例的位置。

这是为内部使用而设计的，通常对子类不感兴趣。

参数:

positions - 实例的位置