概述 | 软件包 | 类 | 使用 | 树 | 索引 | 帮助

上一个类 下一个类 | 框架 无框架
摘要： 嵌套 | 字段 | 构造函数 | 方法 | 详细信息： 字段 | 构造函数 | 方法

## application.workbooks.workbook.documents.document.section
类 AbstractText

    java.lang.Object
      application.workbooks.workbook.documents.document.section.AbstractText

直接已知子类：
  application.workbooks.workbook.shapes.AbstractText, BaseText, EndNote, Footer, FootNote, Header

    public abstract class AbstractText

extends java.lang.Object

该类是正文、页眉、页脚、脚注、尾注的父类，定义了这五种区域内的共用方法，如插入删除文本，格式方字体段落等。

方法摘要
`void` | `changeCase(long offset, long length, int type)` 对指定起始位置指定长度的字符串更改大小写。
`void` | `clearFormats(long offset, long length)` 清除指定位置指定长度的属性（包括字体、段落等属性）。
`void` | `copy(long offset, long length)` 在指定位置复制指定长度的文本（包括图像，域，多媒体等对象）。
`void` | `copyFormat(long offset, long length)` 拷贝格式。
`void` | `cut(long offset, long length)` 在指定位置剪切指定长度的文本（包括图像，域，多媒体等对象）。
`void` | `decreaseIndent(long offset, long length)` 减少缩进。
`void` | `delete(long offset, long length)` 在指定位置删除指定长度的文本（包括图像，域，多媒体等对象）。
`void` | `deleteHyperlink(long offset)` 删除指定位置的超链接。
`void` | `formatStyle(long offset, long length, Style style)` 对指定位置指定长度的字符串格式化其样式。
`BorderAttribute` | `getBorderAttribute(long offset)` 获得指定位置的边框属性。
`WordBulletLevel` | `getBulletLevel(long offset)` 得到指定位置处的项目符号或编号信息。
`WordBulletLevel[]` | `getBulletLevelArray(long offset)` 得到指定位置处的项目符号或编号的列表。
`FindReplace` | `getFindReplace()` 得到当前区域的查找替换管理器。
`FontAttribute` | `getFontAttribute(long offset)` 获得指定位置的字体属性。
`Hyperlink` | `getHyperlink(long offset, long length)` 根据指定位置指定长度取得其超级链接的链接属性，如果当前没有超级链接，那么就插入一个新的超级链接。
`abstract long` | `getLength()` 返回当前章节文本的长度。
`abstract long` | `getOriginPosition()` 获取编辑区域（正文、页眉、页脚、脚注、尾注之一）的起始位置。
`int` | `getPageIndex(long offset)` 得到光标所在页的页码。
`Paragraph` | `getParagraph(long offset)` 返回指定位置的段落。
`ParagraphAttribute` | `getParagraphAttribute(long offset)` 获得指定位置的段落属性。
`Paragraphs` | `getParagraphs()` 得到当前文本区域的段落管理器
`Section` | `getParent()` 得到当前区域对象的父对象。
`TextRange` | `getRange(long offset)` 返回当前章节指定位置的一个文本区域。
`TextRange` | `getRange(long start, long end)` 返回当前章节指定范围的一个文本区域。
`ShadingAttribute` | `getShadingAttribute(long offset)` 获得指定位置的底纹属性。
`abstract java.lang.String` | `getText(long offset, long length)` 返回当前章节指定范围的文本。
`abstract long` | `getTextLength()` 返回当前章节文本的长度。
`void` | `highlight(long offset, long length, java.awt.Color color)` 对指定位置指定长度的字符串设置文字高亮显示。
`void` | `increaseIndent(long offset, long length)` 增加缩进。
`void` | `insertAudio(long offset, java.lang.String filepath)` 在指定位置插入默认大小的声音文件。
`void` | `insertAudio(long offset, java.lang.String filepath, float width, float height)` 在指定位置插入指定大小的声音文件。
`void` | `insertAutoText(long offset, java.lang.String entryName)` 在指定位置插入自动图文集条目。
`void` | `insertAutoText(long offset, java.lang.String entryName, FontAttribute fontAttribute)` 在指定位置插入带有字体属性的自动图文集条目。
`void` | `insertHyperlink(long offset, long length, Hyperlink hyperLink)` 在指定的区域内插入超链接属性。
`void` | `insertNumber(long offset, int number, int type, FontAttribute fontAttribute)` 在指定位置插入带有某种样式并具有指定字体格式的数字。
`void` | `insertParagraph(long offset)` 插入换行符,此时光标到达下一行。
`void` | `insertPicture(long offset, java.lang.String filepath)` 在指定位置插入默认大小的图片。
`void` | `insertPicture(long offset, java.lang.String filepath, float width, float height)` 在指定位置插入指定大小的图片。
`void` | `insertSymbol(int offset, char symbol)` 在指定位置插入一Unicode字符。
`void` | `insertSymbol(int offset, char symbol, FontAttribute fontAttribute)` 在指定位置插入一Unicode字符。
`void` | `insertText(long offset, java.lang.String text)` 在指定位置插入字符串（插入属性为当前位置的输入属性）。
`void` | `insertText(long offset, java.lang.String text, FontAttribute fontAttribute)` 在指定位置插入带有字体属性的字符串。
`void` | `insertTime(long offset, java.lang.String type, boolean update, boolean isSBC)` 在指定位置插入带有某种样式并具有字体属性的时间域。
`void` | `insertVideo(long offset, java.lang.String filepath)` 在指定位置插入默认大小的影像文件。
`void` | `insertVideo(long offset, java.lang.String filepath, float width, float height)` 在指定位置插入指定大小的影像文件。
`void` | `paste(long offset)` 在指定位置粘贴文本（包括图像，域，多媒体等对象）。
`void` | `paste(long offset, long length)` 在指定位置粘贴并替换指定长度的文本（包括图像，域，多媒体等对象）。
`void` | `pasteFormat(long offset, long length)` 粘贴格式。
`void` | `selectAll()` 全选整篇文本。
`void` | `setBorderAttribute(long offset, long length, BorderAttribute borderAttribute)` 对指定位置指定长度的字符串设置边框。
`void` | `setBulletedNumber(long offset, long length, WordBulletLevel wordBulletLevel, boolean isContinue)` 应用项目符号或编号列表到当前选择区域。
`void` | `setBulletedNumber(long offset, long length, WordBulletLevel wordBulletLevel, boolean isContinue, int applyTo)` 应用项目符号和编号列表到当前选择区域。
`void` | `setFontAttribute(long offset, long length, FontAttribute fontAttribute)` 对指定位置指定长度的字符串进行格式化。
`void` | `setOutlinedNumber(long offset, long length, WordBulletLevel[] bulletLevelArray, boolean isContinue)` 应用多级编号列表到当前选择区域。
`void` | `setParagraphAttribute(long offset, long length, ParagraphAttribute paragraphAttribute, boolean replace)` 对指定起始位置指定长度的字符串进行段落格式化。
`void` | `setShadingAttribute(long offset, long length, ShadingAttribute shadingAttribute)` 对指定位置指定长度的字符串设置文字底纹。
`void` | `tcscConverter(boolean sctc)` 对当前章节的整个区域进行简繁体转换。
`void` | `tcscConverter(long offset, long length, boolean sctc)` 对指定位置指定长度的字符串进行简繁体转换。
`void` | `updateField(long offset, long length)` 更新在指定区域内的所有域

从类 java.lang.Object 继承的方法
`equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

方法详细信息

### changeCase

    public void changeCase(long offset,
                           long length,
                           int type)

  对指定起始位置指定长度的字符串更改大小写。

  参数：
    `offset` - 更改文档大小写的起始位置（起始位置为0）
    `length` - 更改文档大小写的长度
    `type` - 更改大小写的类型。只能取以下值之一：

         ChangeCaseConstants.SENTENCECASE    表示句首字母大写
         ChangeCaseConstants.LOWERCASE       表示小写
         ChangeCaseConstants.UPPERCASE       表示大写
         ChangeCaseConstants.TITLECASE       表示词首字母大写
         ChangeCaseConstants.TOGGLECASE      对所选内容进行大小写转换，即大写字母转换为小写，小写字母转换为大写
         ChangeCaseConstants.DBCCASE         表示半角
         ChangeCaseConstants.SBCCASE         表示全角

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.changeCase(2,6,ChangeCaseConstants.UPPERCASE);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当指定的大小写类型不存在
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `ChangeCaseConstants`

### clearFormats

    public void clearFormats(long offset,
                             long length)

  清除指定位置指定长度的属性（包括字体、段落等属性）。

  参数：
    `offset` - 要清除格式的字符串所在位置（起始位置为0）
    `length` - 需要清除的字符串的长度

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         FontAttribute fontAttr = new FontAttribute();
         fontAttr.setBold(true);
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!",fontAttr);
         ParagraphAttribute paraAttr = new ParagraphAttribute();
         paraAttr.setAlignment(ParagraphConstants.ALIGNMENT_CENTER);
         baseText.setParagraphAttribute(0, baseText.getTextLength()-1, paraAttr,false);
         baseText.clearFormats(3,10);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### copy

    public void copy(long offset,
                     long length)

  在指定位置复制指定长度的文本（包括图像，域，多媒体等对象）。

  参数：
    `offset` - 拷贝时指定的起始位置（起始位置为0）
    `length` - 拷贝文本的长度。

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.copy(2,4);
         baseText.paste(0);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### copyFormat

    public void copyFormat(long offset,
                           long length)

  拷贝格式。

  参数：
    `offset` - 设置要拷贝格式的字符串的起始位置（起始位置为0）
    `length` - 设置要拷贝格式字符串的长度

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         FontAttribute fontAttr = new FontAttribute();
         fontAttr.setForeground(java.awt.Color.red);
         baseText.setFontAttribute(2,6,fontAttr);
         baseText.copyFormat(2,6);
         baseText.pasteFormat(10,5);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### cut

    public void cut(long offset,
                    long length)

  在指定位置剪切指定长度的文本（包括图像，域，多媒体等对象）。

  参数：
    `offset` - 剪切时指定的起始位置（起始位置为0）
    `length` - 剪切文本的长度。

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.cut(2,4);
         baseText.paste(0);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### decreaseIndent

    public void decreaseIndent(long offset,
                               long length)

  减少缩进。

  参数：
    `offset` - 光标的起始位置
    `length` - 需要缩进的字符串长度

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.decreaseIndent(2,6);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### delete

    public void delete(long offset,
                       long length)

  在指定位置删除指定长度的文本（包括图像，域，多媒体等对象）。

  参数：
    `offset` - 删除时光标指定的起始位置（起始位置为0）
    `length` - 删除字符的个数（图像，多媒体等对象均属于一个字符,若删除字符个数不超过域代码长度则只删除域，若超过域代码长度则删除域和域后面超过数目的字符个数）

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.delete(2,6);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### deleteHyperlink

    public void deleteHyperlink(long offset)

  删除指定位置的超链接。

  参数：
    `offset` - 偏移位置

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         Hyperlink hyperlink = new Hyperlink();
         hyperlink.setHyperlinkType(HyperlinkConstants.THIS_BINDER_POSITION);
         hyperlink.setShowText("this is a test!");
         hyperlink.hyperlinkToCell("工作表1!A1");
         baseText.insertHyperlink(3,6,hyperlink);
         baseText.deleteHyperlink(4);

### formatStyle

    public void formatStyle(long offset,
                            long length,
                            Style style)

  对指定位置指定长度的字符串格式化其样式。

  参数：
    `offset` - 格式化样式的起始位置（起始位置为0）
    `length` - 格式化样式的长度
    `style` - 样式属性

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         Styles styles = doc.getStyles();
         Style style = styles.getStyle("标题 1");
         baseText.formatStyle(2,10,style);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当样式属性为空
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `Style`

### getBorderAttribute

    public BorderAttribute getBorderAttribute(long offset)

  获得指定位置的边框属性。

  参数：
    `offset` - 指定位置.
  返回：
    边框属性。

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         BorderAttribute borderAttr = new BorderAttribute();
         borderAttr.setApplyType(BorderAndShadingConstants.APPLY_TEXT);
         borderAttr.setBorderType(BorderAndShadingConstants.BORDERTYPE_SHADOW);
         borderAttr.setBorderLineType(BorderAndShadingConstants.TOP,1);
         borderAttr.setBorderLineType(BorderAndShadingConstants.LEFT,3);
         borderAttr.setBorderLineType(BorderAndShadingConstants.RIGHT,6);
         borderAttr.setBorderLineType(BorderAndShadingConstants.BOTTOM,8);
         borderAttr.setBorderLineColor(BorderAndShadingConstants.TOP,Color.RED);
         borderAttr.setBorderLineColor(BorderAndShadingConstants.LEFT,Color.CYAN);
         borderAttr.setBorderLineColor(BorderAndShadingConstants.RIGHT,Color.YELLOW);
         borderAttr.setBorderLineColor(BorderAndShadingConstants.BOTTOM,Color.ORANGE);
         borderAttr.setBorderLineWidth(BorderAndShadingConstants.TOP,8f);
         borderAttr.setBorderLineWidth(BorderAndShadingConstants.LEFT,5f);
         borderAttr.setBorderLineWidth(BorderAndShadingConstants.RIGHT,3f);
         borderAttr.setBorderLineWidth(BorderAndShadingConstants.BOTTOM,1f);
         baseText.setBorderAttribute(2,5,borderAttr);
         BorderAttribute border = baseText.getBorderAttribute(5);
         System.out.println("指定位置的字符边框的类型是："+border.getBorderType());

### getBulletLevel

    public WordBulletLevel getBulletLevel(long offset)

  得到指定位置处的项目符号或编号信息。说明：如果指定位置处是多级编号，则返回这个多级编号列表中的某一级别的编号信息。

  参数：
    `offset` - 指定位置
  返回：
    指定位置处的项目符号或编号信息

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         WordBulletLevel bullet = doc.getWordBulletLevel(BulletNumberConstants.LIST_NUMBER,2);
         baseText.setBulletedNumber(0,10,bullet,false);
         WordBulletLevel bullet = baseText.getBulletLevel(4);
         System.out.println("bullet = "+bullet);

  另请参见：
    `WordBulletLevel`

### getBulletLevelArray

    public WordBulletLevel[] getBulletLevelArray(long offset)

  得到指定位置处的项目符号或编号的列表。 说明：如果指定位置处是项目符号或编号，则此列表返回长度为1的项目符号或编号数组。 如果指定位置处是多级编号，则此列表为一长度为9的项目符号或编号数组。每一数组项代表编号列表的级别。

  参数：
    `offset` - 指定位置
  返回：
    指定位置处的项目符号或编号的列表

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         WordBulletLevel[] levels = doc.getBulletLevelArray(2);
         baseText.setOutlinedNumber(2,20,levels,true);
         WordBulletLevel[] bullets = baseText.getBulletLevelArray(5);
         for (int i = 0; i < bullets.length; i++)
         {
            System.out.println("得到的" + i + "级编号管理器为：" + bullets[i]);
         }

  另请参见：
    `WordBulletLevel`

### getFindReplace

    public FindReplace getFindReplace()

  得到当前区域的查找替换管理器。

  返回：
    返回查找替换管理器

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         FindReplace findReplace = baseText.getFindReplace();
         findReplace.clear();
         findReplace.setText();
         findReplace.execute();

### getFontAttribute

    public FontAttribute getFontAttribute(long offset)

  获得指定位置的字体属性。

  参数：
    `offset` - 指定位置.
  返回：
    字体属性。

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         FontAttribute fontAttr = new FontAttribute();
         fontAttr.setFontSize(18.0);
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!",fontAttr);
         FontAttribute curFont = baseText.getFontAttribute(5);
         System.out.println("指定位置的字体大小是："+ curFont.getFontSize());

### getHyperlink

    public Hyperlink getHyperlink(long offset,
                                  long length)

  根据指定位置指定长度取得其超级链接的链接属性，如果当前没有超级链接，那么就插入一个新的超级链接。 注：如果光标指定位置指定长度内含有表格、工作表、索引目录、连接区域时，不能进行超级链接。含有两个不同的超级链接属性时，那么取第一个属性。

  参数：
    `offset` - 需要超级链接的起始位置（起始位置为0）
    `length` - 需要超级链接的长度
  返回：
    Hyperlink 即超级链接的链接属性

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         Hyperlink hyperlink = baseText.getHyperlink(2,5);
         hyperlink.setHyperlinkType(HyperlinkConstants.THIS_BINDER_POSITION);
         hyperlink.setShowText("this is a test!");
         hyperlink.hyperlinkToCell("工作表1!A1");
         baseText.insertHyperlink(3,6,hyperlink);

  另请参见：
    `Hyperlink`

### getLength

    public abstract long getLength()

  返回当前章节文本的长度。

  返回：
    当前章节文本的长度

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         long length = baseText.getLength();
         System.out.println("当前章节文本的长度是："+length);

### getOriginPosition

    public abstract long getOriginPosition()

  获取编辑区域（正文、页眉、页脚、脚注、尾注之一）的起始位置。

  返回：
    编辑区域（正文、页眉、页脚、脚注、尾注之一）的起始位置

    例子:

         //请输入一些文字
         Document doc = Application.getWorkbooks().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         long originPos = baseText.getOriginPosition();
         System.out.println("当前编辑区域的起始位置是："+ originPos);

### getPageIndex

    public int getPageIndex(long offset)

  得到光标所在页的页码。

  参数：
    `offset` - 在当前章节中光标所在的位置
  返回：
    int 光标所在页的页码

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         section.insertPageBreak(5);
         int pageIndex = baseText.getPageIndex(6);
         System.out.println("光标所在页的页码为："+ pageIndex);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### getParagraph

    public Paragraph getParagraph(long offset)

  返回指定位置的段落。

  参数：
    `offset` - 偏移位置
  返回：
    指定位置的段落

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         Paragraph para = baseText.getParagraph(2);
         System.out.println("参数指定的段落为："+para.getRange().getText());

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### getParagraphAttribute

    public ParagraphAttribute getParagraphAttribute(long offset)

  获得指定位置的段落属性。

  参数：
    `offset` - 指定位置.
  返回：
    段落属性。

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         ParagraphAttribute paraAttr = baseText.getParagraphAttribute(5);
         System.out.println("指定位置的段落对齐方式是："+paraAttr.getAlignment());

### getParagraphs

    public Paragraphs getParagraphs()

  得到当前文本区域的段落管理器

  返回：
    段落管理器

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         Paragraphs paras = baseText.getParagraphs();
         System.out.println("当前正文的段落数为："+paras.getCount());

### getParent

    public Section getParent()

  得到当前区域对象的父对象。

  返回：
    当前对象的父对象

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         section = baseText.getParent();
         System.out.println("当前对象的父对象类型为：" + section.getClass());

### getRange

    public TextRange getRange(long offset)

  返回当前章节指定位置的一个文本区域。说明：这个文本区域指定一个光标位置，文本长度为0。

  参数：
    `offset` - 指定的位置
  返回：
    返回文本区域

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         TextRange range = baseText.getRange(10);
         range.insertText("无锡永中科技有限公司");

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。

### getRange

    public TextRange getRange(long start,
                              long end)

  返回当前章节指定范围的一个文本区域。

  参数：
    `start` - 指定范围起始位置
    `end` - 指定范围结束位置
  返回：
    指定文本区域

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         TextRange range = baseText.getRange(2,6);
         System.out.println("当前章节指定范围的文本是："+ range.getText());

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。

### getShadingAttribute

    public ShadingAttribute getShadingAttribute(long offset)

  获得指定位置的底纹属性。

  参数：
    `offset` - 指定位置.
  返回：
    底纹属性。

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         ShadingAttribute shadingAttr = new ShadingAttribute();
         shadingAttr.setTextureIndex(15);
         baseText.setShadingAttribute(2,10,shadingAttr);
         ShadingAttribute shading = baseText.getShadingAttribute(5);
         System.out.println("指定位置的字符底纹索引是："+shading.getTextureIndex());

### getText

    public abstract java.lang.String getText(long offset,
                                             long length)

  返回当前章节指定范围的文本。

  参数：
    `offset` - 指定范围的起始位置
    `length` - 指定范围的长度
  返回：
    当前章节指定范围的文本

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         String str = baseText.getText(2,6);
         System.out.println("当前章节指定范围的文本是："+ str);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### getTextLength

    public abstract long getTextLength()

  返回当前章节文本的长度。

  返回：
    当前章节文本的长度

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         long length = baseText.getTextLength();
         System.out.println("当前章节文本的长度是："+length);

### highlight

    public void highlight(long offset,
                          long length,
                          java.awt.Color color)

  对指定位置指定长度的字符串设置文字高亮显示。

  参数：
    `offset` - 设置高亮显示的起始位置（起始位置为0）
    `length` - 设置高亮显示的长度
    `color` - 高亮显示的颜色

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.highlight(2,6,java.awt.Color.yellow);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当高亮颜色为空值
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### increaseIndent

    public void increaseIndent(long offset,
                               long length)

  增加缩进。

  参数：
    `offset` - 光标的起始位置
    `length` - 需要增加缩进的字符串长度

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.increaseIndent(2,6);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### insertAudio

    public void insertAudio(long offset,
                            java.lang.String filepath)

  在指定位置插入默认大小的声音文件。

  参数：
    `offset` - 插入声音文件的位置（起始位置为0）
    `filepath` - 插入声音文件的文件路径（绝对路径）

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.insertAudio(6,"d:\\audio.mp3");

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
    `application.exceptions.MacroRunException` - 当声音文件路径不存在
  另请参见：
    `insertAudio(long,String,float,float)`

### insertAudio

    public void insertAudio(long offset,
                            java.lang.String filepath,
                            float width,
                            float height)

  在指定位置插入指定大小的声音文件。

  参数：
    `offset` - 插入声音文件的位置（起始位置为0）
    `filepath` - 插入声音文件的文件路径（绝对路径）
    `width` - 插入声音文件的宽度(以磅为单位，取值返回为0～49994.08磅之间)
    `height` - 插入声音文件的高度(以磅为单位，取值返回为0～49994.08磅之间)

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.insertAudio(6,"d:\\audio.mp3",100f,100f);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
    `application.exceptions.MacroRunException` - 当声音文件路径不存在
    `application.exceptions.MacroRunException` - 当声音文件图标宽度，高度小于0或大于49994.08
  另请参见：
    `insertAudio(long,String)`

### insertAutoText

    public void insertAutoText(long offset,
                               java.lang.String entryName)

  在指定位置插入自动图文集条目。

  参数：
    `offset` - 插入自动图文集条目的起始位置（起始位置为0）
    `entryName` - 需要插入的条目

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.insertAutoText(10,AutoTextConstants.CONFIDENTIAL_PAGE_DATE);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
    `application.exceptions.MacroRunException` - 参数不能为空
  另请参见：
    `insertAutoText(long,String,FontAttribute)`, `AutoTextConstants`

### insertAutoText

    public void insertAutoText(long offset,
                               java.lang.String entryName,
                               FontAttribute fontAttribute)

  在指定位置插入带有字体属性的自动图文集条目。

  参数：
    `offset` - 插入自动图文集条目的起始位置（起始位置为0）
    `entryName` - 需要插入的条目
    `fontAttribute` - 需要插入自动图文集条目的字体属性

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         FontAttribute font = new FontAttribute();
         font.setBold(true);
         font.setFontSize(18);
         baseText.insertAutoText(10,AutoTextConstants.CONFIDENTIAL_PAGE_DATE,font);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
    `application.exceptions.MacroRunException` - 参数不能为空
  另请参见：
    `insertAutoText(long,String)`, `AutoTextConstants`

### insertHyperlink

    public void insertHyperlink(long offset,
                                long length,
                                Hyperlink hyperLink)

  在指定的区域内插入超链接属性。

  参数：
    `offset` - 起始位置
    `length` - 长度
    `hyperLink` - 超链接属性。

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         Hyperlink hyperlink = new Hyperlink();
         hyperlink.setHyperlinkType(HyperlinkConstants.THIS_BINDER_POSITION);
         hyperlink.setShowText("this is a test!");
         hyperlink.hyperlinkToCell("工作表1!A1");
         baseText.insertHyperlink(3,6,hyperlink);

### insertNumber

    public void insertNumber(long offset,
                             int number,
                             int type,
                             FontAttribute fontAttribute)

  在指定位置插入带有某种样式并具有指定字体格式的数字。

  参数：
    `offset` - 插入数字时的光标指定位置（起始位置为0）
    `number` - 具体插入的数字
    `fontAttribute` - 插入数字的指定字体格式
    `type` - 插入数字的样式。只能取以下值之一：

              FieldConstants.DEFAULT      使用默认数字样式
              FieldConstants.Arabic       数字样式为“1,2,3,...”
              FieldConstants.alphabetic   数字样式为“a,b,c,...”
              FieldConstants.ALPHABETIC   数字样式为“A,B,C,...”
              FieldConstants.roman        数字样式为“i,ii,iii,...”
              FieldConstants.ROMAN        数字样式为“I,II,III,...”
              FieldConstants.ORDINAL      数字样式为“1st,2nd,3rd,...”
              FieldConstants.CARDTEXT     数字样式为“One,Two,Three,...”
              FieldConstants.ORDTEXT      数字样式为“First,Second,Third,...”
              FieldConstants.CHINESENUM3  数字样式为“一,二,三(简),...”
              FieldConstants.CHINESENUM2  数字样式为“壹,贰,叁 ,...”
              FieldConstants.ZODIAC1      数字样式为“(1),(2),(3),...”
              FieldConstants.ZODIAC2      数字样式为“①,②,③,...”
              FieldConstants.GB1          数字样式为“壹,贰,叁,...”
              FieldConstants.GB2          数字样式为“甲,乙,丙,...”
              FieldConstants.GB3          数字样式为“子,丑,寅,...”
              FieldConstants.GB4          数字样式为“[一],[二],[三],...”
              FieldConstants.ARABIC_DASH  数字样式为"- 1 -,- 2 -,- 3 -,…"
              FieldConstants.DBCHAR       数字样式为“全角,...”
              FieldConstants.SBCHAR       数字样式为“半角,...”
              FieldConstants.DBNUM1       数字样式为“一,二,三,...”
              FieldConstants.DBNUM2       数字样式为“一,十,百,...”
              FieldConstants.DBNUM3       数字样式为“壱,弐,参,...”
              FieldConstants.DBNUM4       数字样式为“一,二,三,万,...”
              FieldConstants.AIUEO        数字样式为“ア,...”
              FieldConstants.IROHA        数字样式为“イ,...”

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         FontAttribute fontAttr = new FontAttribute();
         fontAttr.setFontSize(18.0);
         baseText.insertNumber(10,5,FieldConstants.ZODIAC2,fontAttr);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### insertParagraph

    public void insertParagraph(long offset)

  插入换行符,此时光标到达下一行。

  参数：
    `offset` - 插入换行符的位置

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.insertParagraph(6);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### insertPicture

    public void insertPicture(long offset,
                              java.lang.String filepath)

  在指定位置插入默认大小的图片。

  参数：
    `offset` - 插入图片的位置（起始位置为0）
    `filepath` - 插入图片的文件路径（绝对路径）

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.insertPicture(6,"d:\\sample.jpg");

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当图片文件路径不存在
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `insertPicture(long,String,float,float)`

### insertPicture

    public void insertPicture(long offset,
                              java.lang.String filepath,
                              float width,
                              float height)

  在指定位置插入指定大小的图片。

  参数：
    `offset` - 插入图片的位置（起始位置为0）
    `filepath` - 插入图片的文件路径（绝对路径）
    `width` - 插入图片的宽度(以磅为单位，取值返回为0～49994.08磅之间)
    `height` - 插入图片的高度(以磅为单位，取值返回为0～49994.08磅之间)

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.insertPicture(6,"d:\\sample.jpg",200f,200f);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当图片文件不存在或为空
    `application.exceptions.MacroRunException` - 当图片宽度，高度小于0或大于49994.08
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `insertPicture(long,String)`

### insertSymbol

    public void insertSymbol(int offset,
                             char symbol)

  在指定位置插入一Unicode字符。

  参数：
    `offset` - 插入字符时的位置（起始位置为0）
    `text` - 需要插入的Unicode码

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         FontAttribute font = new FontAttribute();
         font.setBold(true);
         font.setForeground(Color.red);
         baseText.insertSymbol(0,'?');

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `#insertSymbol(long,char,FontAttribute)`, `FontAttribute`

### insertSymbol

    public void insertSymbol(int offset,
                             char symbol,
                             FontAttribute fontAttribute)

  在指定位置插入一Unicode字符。

  参数：
    `offset` - 插入字符时的位置（起始位置为0）
    `text` - 需要插入的Unicode码
    `fontAttribute` - 插入字符的字体属性

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         FontAttribute font = new FontAttribute();
         font.setBold(true);
         font.setForeground(Color.red);
         baseText.insertSymbol(0,'?',font);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `#insertSymbol(long,char)`, `FontAttribute`

### insertText

    public void insertText(long offset,
                           java.lang.String text)

  在指定位置插入字符串（插入属性为当前位置的输入属性）。

  参数：
    `offset` - 插入字符串时的位置（起始位置为0）
    `text` - 需要插入的字符串

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"无锡永中科技有限公司");

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
    `application.exceptions.MacroRunException` - 当字符串为空
  另请参见：
    `insertText(long,String,FontAttribute)`

### insertText

    public void insertText(long offset,
                           java.lang.String text,
                           FontAttribute fontAttribute)

  在指定位置插入带有字体属性的字符串。

  参数：
    `offset` - 插入字符串时的位置（起始位置为0）
    `text` - 需要插入的字符串
    `fontAttribute` - 插入字符串的字体属性

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         FontAttribute font = new FontAttribute();
         font.setBold(true);
         font.setForeground(Color.red);
         baseText.insertText(0,"无锡永中科技有限公司",font);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当字符串为空
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `insertText(long,String)`, `FontAttribute`

### insertTime

    public void insertTime(long offset,
                           java.lang.String type,
                           boolean update,
                           boolean isSBC)

  在指定位置插入带有某种样式并具有字体属性的时间域。

  参数：
    `offset` - 插入时间域的起始位置（起始位置为0）
    `type` - 插入时间域的类型。只能取以下值之一：

              DateTimeConstants.TIME_hh_mm         时间格式为“14:30”
              DateTimeConstants.TIME_h_mm_PM       时间格式为“2:30 PM”
              DateTimeConstants.TIME_hh_mm_ss      时间格式为“14:30:00”
              DateTimeConstants.TIME_h_mm_ss_PM    时间格式为“2:30:00 PM”
              DateTimeConstants.TIME_HH_MM         时间格式为“14时30分”
              DateTimeConstants.TIME_HH_MM_SS      时间格式为“14时30分00秒”
              DateTimeConstants.TIME_PM_H_M        时间格式为“下午2时30分”
              DateTimeConstants.TIME_PM_H_MM_SS    时间格式为“下午2时30分00秒”
              DateTimeConstants.TIME_HHHH_MMMM     时间格式为“十四时三十分”
              DateTimeConstants.TIME_PM_HH_MMMM    时间格式为“下午二时三十分”

    `update` - 布尔型值，是否更新域。如果为true，则更新域；否则，不更新域
    `isSBC` - 是否是全角字符,当update为false时才可用

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.insertTime(6,DateTimeConstants.TIME_HH_MM,true,false);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度

### insertVideo

    public void insertVideo(long offset,
                            java.lang.String filepath)

  在指定位置插入默认大小的影像文件。

  参数：
    `offset` - 插入影像文件的位置（起始位置为0）
    `filepath` - 插入影像文件的文件路径（绝对路径）

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.insertVideo(6,"d:\\vedio.avi");

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
    `application.exceptions.MacroRunException` - 当影像文件路径不存在
  另请参见：
    `insertVideo(long,String,float,float)`

### insertVideo

    public void insertVideo(long offset,
                            java.lang.String filepath,
                            float width,
                            float height)

  在指定位置插入指定大小的影像文件。

  参数：
    `offset` - 插入影像文件的位置（起始位置为0）
    `filepath` - 插入影像文件的文件路径（绝对路径）
    `width` - 插入影像文件的宽度(以磅为单位，取值返回为0～49994.08磅之间)
    `height` - 插入影像文件的高度(以磅为单位，取值返回为0～49994.08磅之间)

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.insertVideo(6,"d:\\vedio.avi",100f,100f);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
    `application.exceptions.MacroRunException` - 当影像文件路径不存在
    `application.exceptions.MacroRunException` - 当影像文件图标宽度，高度小于0或大于49994.08
  另请参见：
    `insertVideo(long,String)`

### paste

    public void paste(long offset)

  在指定位置粘贴文本（包括图像，域，多媒体等对象）。

  参数：
    `offset` - 粘贴时指定的起始位置（起始位置为0）

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.copy(2,4);
         baseText.paste(0);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `paste(long,long)`

### paste

    public void paste(long offset,
                      long length)

  在指定位置粘贴并替换指定长度的文本（包括图像，域，多媒体等对象）。

  参数：
    `offset` - 粘贴时指定的起始位置（起始位置为0）
    `length` - 粘贴时替换原来字符的个数（图像，域，多媒体等对象均属于一个字符）

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         baseText.copy(2,4);
         baseText.paste(0,10);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `paste(long)`

### pasteFormat

    public void pasteFormat(long offset,
                            long length)

  粘贴格式。

  参数：
    `offset` - 设置要粘贴格式的字符串的起始位置（起始位置为0）
    `length` - 设置要粘贴格式字符串的长度

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         FontAttribute fontAttr = new FontAttribute();
         fontAttr.setForeground(java.awt.Color.red);
         baseText.setFontAttribute(2,6,fontAttr);
         baseText.copyFormat(2,6);
         baseText.pasteFormat(10,5);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### selectAll

    public void selectAll()

  全选整篇文本。

  例子:

       Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
       Section section = doc.getSection(0);
       BaseText baseText = section.getBaseText();
       baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
       baseText.selectAll();

  抛出：
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

### setBorderAttribute

    public void setBorderAttribute(long offset,
                                   long length,
                                   BorderAttribute borderAttribute)

  对指定位置指定长度的字符串设置边框。

  参数：
    `offset` - 要设置文字边框的字符串位置（起始位置为0）
    `length` - 要设置文字边框的字符串的长度
    `borderAttribute` - 要设置的边框属性

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         BorderAttribute borderAttr = new BorderAttribute();
         borderAttr.setBorderType(BorderAndShadingConstants.BORDERTYPE_SHADOW);
         borderAttr.setBorderLineType(BorderAndShadingConstants.TOP,1);
         borderAttr.setBorderLineType(BorderAndShadingConstants.LEFT,3);
         borderAttr.setBorderLineType(BorderAndShadingConstants.RIGHT,6);
         borderAttr.setBorderLineType(BorderAndShadingConstants.BOTTOM,8);
         borderAttr.setBorderLineColor(BorderAndShadingConstants.TOP,Color.RED);
         borderAttr.setBorderLineColor(BorderAndShadingConstants.LEFT,Color.CYAN);
         borderAttr.setBorderLineColor(BorderAndShadingConstants.RIGHT,Color.YELLOW);
         borderAttr.setBorderLineColor(BorderAndShadingConstants.BOTTOM,Color.ORANGE);
         borderAttr.setBorderLineWidth(BorderAndShadingConstants.TOP,8f);
         borderAttr.setBorderLineWidth(BorderAndShadingConstants.LEFT,5f);
         borderAttr.setBorderLineWidth(BorderAndShadingConstants.RIGHT,3f);
         borderAttr.setBorderLineWidth(BorderAndShadingConstants.BOTTOM,1f);
         baseText.setBorderAttribute(2,25,borderAttr);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当边框属性为空
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `BorderAttribute`

### setBulletedNumber

    public void setBulletedNumber(long offset,
                                  long length,
                                  WordBulletLevel wordBulletLevel,
                                  boolean isContinue)

  应用项目符号或编号列表到当前选择区域。

  参数：
    `offset` - 应用列表对象的起始位置
    `length` - 需要应用列表对象的文本长度
    `wordBulletLevel` - 列表对象，此对象的列表类型必须为项目符号或编号
    `isContinue` - 布尔型值，是否继续。如果为true，在对话盒中选择的是继续；如果为false，则选择重新开始

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         WordBulletLevel bullet = baseText.getWordBulletLevel(BulletNumberConstants.LIST_BULLET,2);
         baseText.setBulletedNumber(2,20,bullet,true);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当列表对象为空或列表类型不是项目符号或编号
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `WordBulletLevel`

### setBulletedNumber

    public void setBulletedNumber(long offset,
                                  long length,
                                  WordBulletLevel wordBulletLevel,
                                  boolean isContinue,
                                  int applyTo)

  应用项目符号和编号列表到当前选择区域。

  参数：
    `offset` - 应用列表对象的起始位置
    `length` - 需要应用列表对象的文本长度
    `wordBulletLevel` - 列表对象，此对象的列表类型必须为项目符号或编号
    `isContinue` - 布尔型值，是否继续。如果为true，在对话盒中选择的是继续；如果为false，则选择重新开始
    `applyTo` - 列表应用范围，只能取以下值之一：

         BulletNumberConstants.APPLY_TO_WHOLE_LIST = 0     整个列表
         BulletNumberConstants.APPLY_TO_AFTER_INSERT = 1   插入点之后
         ABulletNumberConstants.PPLY_TO_SELECTED_RANGE = 2 所选文字/当前段

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         WordBulletLevel bullet = baseText.getWordBulletLevel(BulletNumberConstants.LIST_BULLET,2);
         baseText.setBulletedNumber(2,20,bullet,true,BulletNumberConstants.APPLY_TO_WHOLE_LIST);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当列表对象为空或列表类型不是项目符号或编号
    `application.exceptions.MacroRunException` - 当列表应用范围的常量不存在
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `WordBulletLevel`

### setFontAttribute

    public void setFontAttribute(long offset,
                                 long length,
                                 FontAttribute fontAttribute)

  对指定位置指定长度的字符串进行格式化。

  参数：
    `offset` - 格式化字符的开始位置（起始位置为0）
    `length` - 格式化字符的长度
    `fontAttribute` - 格式化字符的字体属性

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         FontAttribute font = new FontAttribute();
         font.setBold(true);
         font.setForeground(Color.red);
         baseText.setFontAttribute(2,6,font);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当字体属性为空
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `FontAttribute`

### setOutlinedNumber

    public void setOutlinedNumber(long offset,
                                  long length,
                                  WordBulletLevel[] bulletLevelArray,
                                  boolean isContinue)

  应用多级编号列表到当前选择区域。

  参数：
    `offset` - 应用多级列表对象的起始位置
    `length` - 需要应用多级列表对象的文本长度
    `bulletLevelArray[]` - 多级编号列表对象，用数组表示，其中数组中的每一项表示多级编号对象中每一级的编号信息
    `isContinue` - 布尔型值，是否继续。如果为true，在对话盒中选择的是继续；如果为false，则选择重新开始

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         WordBulletLevel[] levels = baseText.getBulletLevelArray(3);
         baseText.setOutlinedNumber(2,20,levels,true);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当列表对象数组为空或数组项为空或其列表类型不是多级编号
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `WordBulletLevel`

### setParagraphAttribute

    public void setParagraphAttribute(long offset,
                                      long length,
                                      ParagraphAttribute paragraphAttribute,
                                      boolean replace)

  对指定起始位置指定长度的字符串进行段落格式化。

  参数：
    `startOffset` - 格式化字符段落属性的起始位置（起始位置为0）
    `length` - 格式化字符段落属性的长度
    `paragraphAttribute` - 格式化字符的段落属性
    `replace` - 布尔型值，是否替换原先的属性。如果为true，则表示替换原先的属性（如：只能设置首行缩进或悬挂缩进中的一种属性）；否则，表示保留原先属性（如：设置首行缩进时可保留原先的悬挂缩进属性）

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         ParagraphAttribute paraAttr = new ParagraphAttribute();
         paraAttr.setAlignment(ParagraphConstants.ALIGNMENT_CENTER);
         baseText.setParagraphAttribute(2,4,paraAttr,true);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当段落属性为空
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `ParagraphAttribute`

### setShadingAttribute

    public void setShadingAttribute(long offset,
                                    long length,
                                    ShadingAttribute shadingAttribute)

  对指定位置指定长度的字符串设置文字底纹。

  参数：
    `offset` - 要设置文字底纹的字符串的位置（起始位置为0）
    `length` - 要设置文字底纹的字符串的长度
    `shadingAttribute` - 要设置的底纹属性

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         ShadingAttribute shadingAttr = new ShadingAttribute();
         shadingAttr.setTextureIndex(15);
         baseText.setShadingAttribute(2,10,shadingAttr);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当底纹属性为空
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `ShadingAttribute`

### tcscConverter

    public void tcscConverter(boolean sctc)

  对当前章节的整个区域进行简繁体转换。

  参数：
    `sctc` - 布尔型值，如果为true，则表示简体转换到繁体；否则，表示繁体转换到简体

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"中华人民共和国");
         baseText.tcscConverter(true);

  抛出：
    `application.exceptions.MacroRunException` - 当章节区域中存在保护区域
  另请参见：
    `tcscConverter(long,long,boolean)`

### tcscConverter

    public void tcscConverter(long offset,
                              long length,
                              boolean sctc)

  对指定位置指定长度的字符串进行简繁体转换。

  参数：
    `offset` - 进行简繁体转换的开始位置（起始位置为0）
    `length` - 简繁体转换的转换长度
    `sctc` - 布尔型值，如果为true，则表示简体转换到繁体；否则，表示繁体转换到简体

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         baseText.insertText(0,"中华人民共和国");
         baseText.tcscConverter(0,5,true);

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域
  另请参见：
    `tcscConverter(boolean)`

### updateField

    public void updateField(long offset,
                            long length)

  更新在指定区域内的所有域

  参数：
    `offset` - 指定区域的起始位置
    `length` - 指定区域的长度

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         final BaseText baseText = section.getBaseText();
         baseText.insertText(0,"this is a test!\nthis is a test!\nthis is a test!");
         Fields fields = doc.getFields();
         fields.insert(5,baseText,FieldConstants.FIELDTYPE_CREATE_DATE,"CREATEDATE \\@ \"HH:mm:ss\" \\* MERGEFORMAT ");
         javax.swing.Timer timer = new javax.swing.Timer(1000,new ActionListener(){
             void actionPerformed(ActionEvent e)
             {
                 baseText.updateField(0,20);
             }
         });
         timer.start();

  抛出：
    `application.exceptions.MacroRunException` - 当offset小于0或大于文档长度。
    `application.exceptions.MacroRunException` - 当offset + length 大于文档长度。
    `application.exceptions.MacroRunException` - 当指定区域中存在保护区域

概述 | 软件包 | 类 | 使用 | 树 | 索引 | 帮助

上一个类 下一个类 | 框架 无框架
摘要： 嵌套 | 字段 | 构造函数 | 方法 | 详细信息： 字段 | 构造函数 | 方法