Range
遗产： java.lang.Object
public class Range
表示文档中的一个连续区域。
要了解更多信息，请访问Working with Ranges文档文章。
文档由节点树表示，节点提供操作树的操作，但如果将文档视为连续的文本序列，则某些操作更容易执行。
Range是一个“外观”接口，它提供将文档或文档的一部分视为“平面”文本的方法，而不管文档节点存储在树状对象模型中的事实。
Range不包含任何文本或节点，它只是文档片段上的视图或“窗口”。
方法
| 方法 | 描述 |
|---|---|
| delete() | 删除范围内的所有字符。 |
| equals(Object arg0) | |
| getBookmarks() | 返回一个getBookmarks()代表范围内所有书签的集合。 |
| getClass() | |
| getFields() | 返回一个getFields()表示范围内所有字段的集合。 |
| getFormFields() | 返回一个getFormFields()表示范围内所有表单字段的集合。 |
| getStructuredDocumentTags() | 返回一个getStructuredDocumentTags()表示范围内所有结构化文档标签的集合。 |
| getText() | 获取范围的文本。 |
| hashCode() | |
| normalizeFieldTypes() | 更改字段类型值FieldChar.getFieldType()的FieldStart, FieldSeparator, FieldEnd在此范围内，以便它们对应于字段代码中包含的字段类型。 |
| notify() | |
| notifyAll() | |
| replace(String pattern, String replacement) | 用替换字符串替换所有出现的指定字符串模式。 |
| replace(String pattern, String replacement, FindReplaceOptions options) | 用替换字符串替换所有出现的指定字符串模式。 |
| replace(Pattern pattern, String replacement) | 用另一个字符串替换由正则表达式指定的字符模式的所有匹配项。 |
| replace(Pattern pattern, String replacement, FindReplaceOptions options) | 用另一个字符串替换由正则表达式指定的字符模式的所有匹配项。 |
| toDocument() | 构造一个包含范围的新的完全形成的文档。 |
| toString() | |
| unlinkFields() | 取消链接此范围内的字段。 |
| updateFields() | 更新此范围内文档字段的值。 |
| wait() | |
| wait(long arg0) | |
| wait(long arg0, int arg1) |
delete()
public void delete()
删除范围内的所有字符。
equals(Object arg0)
public boolean equals(Object arg0)
参数：
| 范围 | 类型 | 描述 |
|---|---|---|
| arg0 | java.lang.Object |
退货： 布尔值
getBookmarks()
public BookmarkCollection getBookmarks()
返回一个getBookmarks()代表范围内所有书签的集合。
退货： BookmarkCollection - 一个getBookmarks()代表范围内所有书签的集合。
getClass()
public final native Class<?> getClass()
退货： java.lang.Class
getFields()
public FieldCollection getFields()
返回一个getFields()表示范围内所有字段的集合。
退货： FieldCollection - 一个getFields()表示范围内所有字段的集合。
getFormFields()
public FormFieldCollection getFormFields()
返回一个getFormFields()表示范围内所有表单字段的集合。
退货： FormFieldCollection - 一个getFormFields()表示范围内所有表单字段的集合。
getStructuredDocumentTags()
public StructuredDocumentTagCollection getStructuredDocumentTags()
返回一个getStructuredDocumentTags()表示范围内所有结构化文档标签的集合。
退货： StructuredDocumentTagCollection - 一个getStructuredDocumentTags()表示范围内所有结构化文档标签的集合。
getText()
public String getText()
获取范围的文本。
返回的字符串包括所有控制字符和特殊字符，如ControlChar.
退货： java.lang.String - 范围的文本。
hashCode()
public native int hashCode()
退货： 整数
normalizeFieldTypes()
public void normalizeFieldTypes()
更改字段类型值FieldChar.getFieldType()的FieldStart, FieldSeparator, FieldEnd在此范围内，以便它们对应于字段代码中包含的字段类型。
在影响字段类型的文档更改后使用此方法。
要更改整个文档中的字段类型值，请使用Document.normalizeFieldTypes().
notify()
public final native void notify()
notifyAll()
public final native void notifyAll()
replace(String pattern, String replacement)
public int replace(String pattern, String replacement)
用替换字符串替换所有出现的指定字符串模式。
该模式不会用作正则表达式。请用replace(java.util.regex.Pattern, java.lang.String)如果你需要正则表达式。
使用不区分大小写的比较。
方法能够处理模式和替换字符串中的中断。
如果你需要使用中断，你应该使用特殊的元字符：
- &p - 段落中断
- &b \分节符
- &m \分页符
- &l \手动换行
使用方法replace(java.lang.String, java.lang.String, com.aspose.words.FindReplaceOptions)进行更灵活的定制。
参数：
| 范围 | 类型 | 描述 |
|---|---|---|
| pattern | java.lang.String | 要替换的字符串。 |
| replacement | java.lang.String | 替换所有出现的模式的字符串。 |
退货： int - 进行的替换次数。
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Numbers 1, 2, 3");
// Inserts paragraph break after Numbers.
doc.Range.Replace("Numbers", "Numbers&p", new FindReplaceOptions());
replace(String pattern, String replacement, FindReplaceOptions options)
public int replace(String pattern, String replacement, FindReplaceOptions options)
用替换字符串替换所有出现的指定字符串模式。
该模式不会用作正则表达式。请用replace(java.util.regex.Pattern, java.lang.String, com.aspose.words.FindReplaceOptions)如果你需要正则表达式。
方法能够处理模式和替换字符串中的中断。
如果你需要使用中断，你应该使用特殊的元字符：
- &p - 段落中断
- &b \分节符
- &m \分页符
- &l \手动换行
- && - ＆ 特点
参数：
| 范围 | 类型 | 描述 |
|---|---|---|
| pattern | java.lang.String | 要替换的字符串。 |
| replacement | java.lang.String | 替换所有出现的模式的字符串。 |
| options | FindReplaceOptions | {FindReplaceOptions对象以指定其他选项。 |
退货： int - 进行的替换次数。
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Numbers 1, 2, 3");
// Inserts paragraph break after Numbers.
doc.Range.Replace("Numbers", "Numbers&p", new FindReplaceOptions());
replace(Pattern pattern, String replacement)
public int replace(Pattern pattern, String replacement)
用另一个字符串替换由正则表达式指定的字符模式的所有匹配项。
替换正则表达式捕获的整个匹配项。
方法能够处理模式和替换字符串中的中断。
如果你需要使用中断，你应该使用特殊的元字符：
- &p - 段落中断
- &b \分节符
- &m \分页符
- &l \手动换行
使用方法replace(java.util.regex.Pattern, java.lang.String, com.aspose.words.FindReplaceOptions)进行更灵活的定制。
参数：
| 范围 | 类型 | 描述 |
|---|---|---|
| pattern | java.util.regex.Pattern | 用于查找匹配项的正则表达式模式。 |
| replacement | java.lang.String | 替换所有出现的模式的字符串。 |
退货： int - 进行的替换次数。
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("a1, b2, c3");
// Replaces each number with paragraph break.
doc.Range.Replace(new Regex(@"\d+"), "&p");
replace(Pattern pattern, String replacement, FindReplaceOptions options)
public int replace(Pattern pattern, String replacement, FindReplaceOptions options)
用另一个字符串替换由正则表达式指定的字符模式的所有匹配项。
替换正则表达式捕获的整个匹配项。
方法能够处理模式和替换字符串中的中断。
如果你需要使用中断，你应该使用特殊的元字符：
- &p - 段落中断
- &b \分节符
- &m \分页符
- &l \手动换行
- && - ＆ 特点
参数：
| 范围 | 类型 | 描述 |
|---|---|---|
| pattern | java.util.regex.Pattern | 用于查找匹配项的正则表达式模式。 |
| replacement | java.lang.String | 替换所有出现的模式的字符串。 |
| options | FindReplaceOptions | {FindReplaceOptions对象以指定其他选项。 |
退货： int - 进行的替换次数。
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("a1, b2, c3");
// Replaces each number with paragraph break.
doc.Range.Replace(new Regex(@"\d+"), "&p", new FindReplaceOptions());
toDocument()
public Document toDocument()
构造一个包含范围的新的完全形成的文档。
退货： Document
toString()
public String toString()
退货： java.lang.字符串
unlinkFields()
public void unlinkFields()
取消链接此范围内的字段。
将此范围内的所有字段替换为其最近的结果。
要取消链接整个文档中的字段，请使用unlinkFields().
updateFields()
public void updateFields()
更新此范围内文档字段的值。
当您打开、修改然后保存文档时，Aspose.Words 不会自动更新字段，而是保持它们的完整性。因此，如果您以编程方式修改了文档并希望确保正确的（计算的）字段值出现在保存的文档中，则通常需要在保存之前调用此方法。
执行邮件合并后不需要更新字段，因为邮件合并是一种字段更新，会自动更新文档中的所有字段。
此方法不会更新所有字段类型。有关支持的字段类型的详细列表，请参阅《程序员指南》。
此方法不会更新与页面布局算法相关的字段（例如 PAGE、PAGES、PAGEREF）。当您呈现文档或调用时，页面布局相关的字段会更新Document.updatePageLayout().
要更新整个文档中的字段，请使用Document.updateFields().
wait()
public final void wait()
wait(long arg0)
public final native void wait(long arg0)
参数：
| 范围 | 类型 | 描述 |
|---|---|---|
| arg0 | long |
wait(long arg0, int arg1)
public final void wait(long arg0, int arg1)
参数：
| 范围 | 类型 | 描述 |
|---|---|---|
| arg0 | long | |
| arg1 | int |
