Richtext 接口 — oosxl 0.1.0 文档

# Richtext 接口

Richtext 接口代表具有多种格式的文本内容，包含多个文本段，每个文本段可以具有不同的样式属性。

## 类

class oo::iRichtext

  管理具有多个格式段的富文本内容的接口。

  ### 文本信息

  int segments_num() const

    获取富文本中的文本段数量。

    返回:

      文本段数量

  const char *plain_text() const

    获取不带格式的完整的朴素文本内容。

    返回:

      纯文本内容

  ### 文本段访问

  const char *text(int index, iStyle **style = nullptr) const

    获取特定段的文本和样式。

    参数:

      - index -- 段索引(基于 0)

      - style -- 存储样式对象指针的指针(可选)

    返回:

      段的文本内容

    备注

    如果提供了 style 参数且该段有样式，将存储样式。

  ### 文本内容修改

  void append(const char *s, iStyle *style = nullptr)

    向富文本追加新的文本段。

    参数:

      - s -- 要追加的文本内容

      - style -- 应用于新段的样式(可选)

  void insert(int index, const char *s, iStyle *style = nullptr)

    在指定位置插入新的文本段。

    参数:

      - index -- 插入位置(0-based)

      - s -- 要插入的文本内容

      - style -- 应用于新段的样式(可选)

  void remove(int index)

    移除文本段。

    参数:

      index -- 要移除的段索引(0-based)

  void modify(int index, const char *s, iStyle *style = nullptr)

    修改现有的文本段。

    参数:

      - index -- 要修改的段索引(0-based)

      - s -- 新的文本内容

      - style -- 要应用的新样式(可选，nullptr 保持现有样式)

  ### 资源管理

  void release()

    释放富文本对象并清理相关资源。

    备注

    当不再需要 Richtext 对象时应调用此方法，以释放内存。

## 使用示例

    #include "oosxl.hxx"

    // Create rich text object
    oo::iRichtext* richText = workbook->make_richtext();

    // Create styles for different segments
    oo::iStyle* boldStyle = workbook->make_normal_style();
    boldStyle->set_bold(true);
    boldStyle->set_font_size(14);

    oo::iStyle* redStyle = workbook->make_normal_style();
    redStyle->set_font_color(RGB(255, 0, 0));
    redStyle->set_italic(true);

    // Add formatted segments
    richText->append("This is ", nullptr);  // Normal text
    richText->append("bold", boldStyle);    // Bold text
    richText->append(" and ", nullptr);     // Normal text
    richText->append("red italic", redStyle); // Red italic text

    // Apply to cell
    worksheet->set_richtext(0, 0, richText);

    // Get information about segments
    int segmentCount = richText->segments_num();
    for (int i = 0; i < segmentCount; ++i) {
        oo::iStyle* segmentStyle = nullptr;
        const char* text = richText->text(i, &segmentStyle);
        // Process segment...
    }

    // Get plain text
    const char* plainText = richText->plain_text();
    // plainText = "This is bold and red italic"

    // Clean up
    boldStyle->release();
    redStyle->release();
    richText->release();

Styled using the Piccolo Theme