Struct Run 

pub struct Run {
    pub text: String,
    pub properties: RunProperties,
}

一个 Run：<a:r> + 文本。

Fields

text: String

文本内容。若以 "\n" 开头（且不包含其他非空白字符）则被识别为换行 Run。

properties: RunProperties

Run 属性。

Implementations

impl Run

pub fn new(text: impl Into<String>) -> Run

构造一个普通 Run。

pub fn line_break() -> Run

构造一个换行 Run（等价于“软回车“，OOXML 表达为 <a:br/>）。

pub fn write_xml(&self, w: &mut XmlWriter)

写 XML。

pub fn text(&self) -> &str

取 Run 文本。

pub fn set_text(&mut self, t: impl Into<String>)

设置 Run 文本（不支持 "\n"，换行请用 Run::line_break）。

pub fn size(&self) -> Option<Pt>

Run 字体大小（Pt）。

pub fn set_size(&mut self, v: Pt)

设置 Run 字体大小。

pub fn bold(&self) -> bool

是否加粗。

pub fn set_bold(&mut self, v: bool)

设置加粗。

pub fn italic(&self) -> bool

是否斜体。

pub fn set_italic(&mut self, v: bool)

设置斜体。

pub fn color(&self) -> Color

颜色便捷访问（拷贝）。

pub fn set_color(&mut self, c: impl Into<Color>)

设置颜色（接受 RGBColor / SchemeColor / PresetColor 任一）。

pub fn font_name(&self) -> Option<&str>

字体名（拉丁 / 主体）。

pub fn set_font_name(&mut self, name: impl Into<String>)

设置字体名。

pub fn eastasia_name(&self) -> Option<&str>

东亚字体名（<a:ea typeface="..."/>，对应中文/日文/韩文字体）。

与 Run::font_name（拉丁字体）配对使用：PowerPoint 根据字符脚本 自动切换 latin/ea 字体。例如同一 Run 内 “Hello 你好” 会用 latin 字体 渲染 “Hello”，用 ea 字体渲染 “你好”。

pub fn set_eastasia_name(&mut self, name: impl Into<String>)

设置东亚字体名。

参数

• name：东亚字体名称（如 "宋体" / "Microsoft YaHei" / "MS Mincho"）。

pub fn complex_script_name(&self) -> Option<&str>

复杂脚本字体名（<a:cs typeface="..."/>，对应阿拉伯语/希伯来语/泰语等）。

复杂脚本需要双向排版（RTL）或连字处理，PowerPoint 用 cs 字体渲染这类字符。

pub fn set_complex_script_name(&mut self, name: impl Into<String>)

设置复杂脚本字体名。

参数

• name：复杂脚本字体名称（如 "Arial" / "Tahoma" / "Traditional Arabic"）。

pub fn underline(&self) -> Option<Underline>

下划线便捷访问。

pub fn set_underline(&mut self, v: Underline)

设置下划线。

pub fn strike(&self) -> bool

是否删除线。

pub fn set_strike(&mut self, v: bool)

设置删除线。

pub fn double_strike(&self) -> bool

是否双删除线（TODO-017 高阶 API）。

pub fn set_double_strike(&mut self, v: bool)

设置双删除线（TODO-017 高阶 API）。

pub fn highlight(&self) -> Option<&Color>

取高亮背景色（TODO-018 高阶 API）。

返回 None 表示未设置高亮。

pub fn set_highlight(&mut self, color: Option<Color>)

设置高亮背景色（TODO-018 高阶 API）。

传入 None 清除高亮。

pub fn clear_highlight(&mut self)

清除高亮（TODO-018 高阶 API 便捷方法）。

pub fn hlink_click(&self) -> Option<&Hyperlink>

取点击超链接（TODO-026 高阶 API）。

pub fn set_hlink_click(&mut self, hl: Hyperlink)

设置点击超链接（TODO-026 高阶 API）。

pub fn clear_hlink_click(&mut self)

清除点击超链接（TODO-026 高阶 API）。

pub fn hlink_hover(&self) -> Option<&Hyperlink>

取悬停超链接（TODO-026 高阶 API）。

pub fn set_hlink_hover(&mut self, hl: Hyperlink)

设置悬停超链接（TODO-026 高阶 API）。

pub fn clear_hlink_hover(&mut self)

清除悬停超链接（TODO-026 高阶 API）。

pub fn set_hyperlink(&mut self, rid: impl Into<String>, tooltip: Option<&str>)

设置外部 URL 超链接（TODO-026 高阶 API 便捷方法）。

对标 python-pptx run.hyperlink.address = url。

参数

• rid：关系 id（指向 slide .rels 中注册的外部 URL）。 注意：本方法只设置 run 的 hlinkClick，不负责创建 OPC 关系。 调用方需自行在 slide 的 .rels 中注册该 URL 并取得 rid。
• tooltip：可选悬停提示文本；None 表示不写出 tooltip 属性。

示例

let mut run = Run::new("点击");
run.set_hyperlink("rIdHlink1", Some("打开链接"));

pub fn set_slide_jump(&mut self)

设置跳转幻灯片动作超链接（TODO-026 高阶 API 便捷方法）。

对标 python-pptx run.hyperlink.action = "ppaction://hlinksldjump"。

说明

仅设置 action = ppaction://hlinksldjump，具体跳转目标由 slide .rels 中的关系决定（调用方需自行注册）。若要同时绑定目标 slide，需配合 Hyperlink::new(rid) 手动设置 rid + action。

pub fn font(&mut self) -> Font<'_>

取 Font 高阶视图（用于批量设置字体属性、超链接等）。

对标 python-pptx run.font。

Trait Implementations

impl Clone for Run

fn clone(&self) -> Run

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Run

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for Run

fn default() -> Run

Returns the “default value” for a type.