ITextRun

Interface ITextRun

---

public interface ITextRun

表示 IRichText 对象中的一段字符区域。

ITextRun 对象用于表示单元格富文本中一段连续文本及其字符级格式。可通过 IRichText.add(String) 或 IRange.characters(int,int) 返回的字符区域获取此接口。

 IRichText richText = worksheet.getRange("A1").getRichText();
 ITextRun textRun = richText.add("Document");
 textRun.getFont().setBold(true);
 textRun.setText("Document Solutions");
 

• Method Summary

  All MethodsInstance MethodsAbstract Methods

  Modifier and Type

  Method

  Description

  void

  delete()

  从其父级 IRichText 对象中删除此 ITextRun。

  IFont

  getFont()

  获取当前文本段的字体设置。

  String

  getText()

  获取当前文本段的文本。

  ITextRun

  insertAfter(String text)

  在当前文本段之后插入新的 ITextRun。

  ITextRun

  insertBefore(String text)

  在当前文本段之前插入新的 ITextRun。

  void

  setText(String text)

  设置当前文本段的文本。

• Method Details

  • getFont

    IFont getFont()

    获取当前文本段的字体设置。

    使用返回的 IFont 对象可以访问或修改应用于当前文本段的字体格式。

    
     IRichText richText = worksheet.getRange("A1").getRichText();
     ITextRun run = richText.add("Document");
     IFont font = run.getFont();
     font.setBold(true);
     

    Returns:

    当前文本段的字体设置。

  • getText

    String getText()

    获取当前文本段的文本。

    使用此方法可以检索当前文本段在其父级 IRichText 对象中表示的字符序列。

    
     IRichText richText = worksheet.getRange("A1").getRichText();
     ITextRun run = richText.add("Document Solutions");
     String text = run.getText();
     

    Returns:

    当前文本段的文本。

  • setText

    void setText(String text)

    设置当前文本段的文本。

    使用此方法可以替换当前文本段在其父级 IRichText 对象中表示的字符序列。

    
     IRichText richText = worksheet.getRange("A1").getRichText();
     ITextRun run = richText.add("Document Solutions");
     run.setText("Sample");
     

    Parameters:

    text - 当前文本段的文本。

  • delete

    void delete()

    从其父级 IRichText 对象中删除此 ITextRun。

    使用此方法可以从单元格的富文本内容中移除当前文本段。

    
     IRichText richText = worksheet.getRange("A1").getRichText();
     richText.add("Hello");
     ITextRun textRun = worksheet.getRange("A1").characters(1, 3);
     textRun.delete();
     

  • insertBefore

    ITextRun insertBefore(String text)

    在当前文本段之前插入新的 ITextRun。

    在父级 IRichText 对象中当前文本段之前立即添加一个新的文本段。

    
     IRichText richText = worksheet.getRange("A1").getRichText();
     richText.add("Hello");
     ITextRun textRun = worksheet.getRange("A1").characters(1, 3);
     ITextRun insertedRun = textRun.insertBefore("World");
     insertedRun.getFont().setBold(true);
     

    Parameters:

    text - 新插入文本段的文本。

    Returns:

    新创建的 ITextRun。

  • insertAfter

    ITextRun insertAfter(String text)

    在当前文本段之后插入新的 ITextRun。

    在父级 IRichText 对象中当前文本段之后立即添加一个新的文本段。

    
     IRichText richText = worksheet.getRange("A1").getRichText();
     richText.add("Hello");
     ITextRun textRun = worksheet.getRange("A1").characters(1, 3);
     ITextRun insertedRun = textRun.insertAfter("World");
     insertedRun.getFont().setBold(true);
     

    Parameters:

    text - 新插入文本段的文本。

    Returns:

    新创建的 ITextRun；如果当前文本段在父级富文本对象中已不再可用，则返回 null。