# Rich Text API 参考

## 概述

Richtext API 提供创建和操作 Excel 单元格中富文本内容的函数，允许在单个单元格内使用多种样式的格式化文本。

## 富文本信息

int rt_segments_num(RichtextHandle rt)

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

  参数:

    - rt -- Richtext 句柄

  返回:

    文本段数量。

const char *rt_plain_text(RichtextHandle rt)

  获取富文本的纯文本内容。

  参数:

    - rt -- Richtext 句柄

  返回:

    纯文本字符串。

## 文本段操作

const char *rt_text(RichtextHandle rt, int index, StyleHandle *style)

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

  参数:

    - rt -- Richtext 句柄

    - index -- 文本段索引(0-based)。

    - style -- 存储文本段样式句柄的指针。

  返回:

    文本段的文本内容。

void rt_append(RichtextHandle rt, const char *s, StyleHandle style)

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

  参数:

    - rt -- Richtext 句柄

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

    - style -- 新文本段的样式。

void rt_insert(RichtextHandle rt, int index, const char *s, StyleHandle style)

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

  参数:

    - rt -- Richtext 句柄

    - index -- 插入文本段的位置。

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

    - style -- 新文本段的样式。

void rt_remove(RichtextHandle rt, int index)

  从富文本中移除文本段。

  参数:

    - rt -- Richtext 句柄

    - index -- 要移除的文本段索引。

void rt_modify(RichtextHandle rt, int index, const char *s, StyleHandle style)

  修改现有的文本段。

  参数:

    - rt -- Richtext 句柄

    - index -- 要修改的文本段索引。

    - s -- 新的文本内容。

    - style -- 文本段的新样式。

## 资源管理

void rt_release(RichtextHandle rt)

  释放富文本资源。

  参数:

    - rt -- 要释放的富文本句柄。

## 使用示例

富文本的典型使用模式:

    // Create rich text from workbook
    RichtextHandle rt = wb_make_richtext(workbook);

    // Append segments with different styles
    rt_append(rt, "This is ", normal_style);
    rt_append(rt, "bold", bold_style);
    rt_append(rt, " and ", normal_style);
    rt_append(rt, "italic", italic_style);
    rt_append(rt, " text.", normal_style);

    // Apply to cell
    ws_set_richtext(worksheet, 1, 1, rt);

    // Release when done
    rt_release(rt);

Styled using the Piccolo Theme