Struct Chart 

pub struct Chart {
    pub chart_type: ChartType,
    pub data: ChartData,
    pub rid: String,
    pub external_data_rid: Option<String>,
}

一个完整的图表，引用 chart part。

Fields

chart_type: ChartType

图表类型。

data: ChartData

图表数据。

rid: String

关系 id（指向 /ppt/charts/chartN.xml）。

由 Presentation::to_opc_package 在写出 chart part 时自动分配。 高阶 API 创建时通常为空字符串，由 presentation 层填充。

external_data_rid: Option<String>

嵌入式 Excel 工作簿的关系 id（TODO-004 Excel 嵌入）。

指向 /ppt/embeddings/Microsoft_Excel_WorksheetN.xlsx，写出时在 </c:chart> 之后、</c:chartSpace> 之前生成 <c:externalData r:id="..."><c:autoUpdate val="0"/></c:externalData>。

• None：不写出 <c:externalData>（图表数据仅靠 numCache/strCache）。
• Some(rid)：写出 <c:externalData r:id="{rid}"/>，PowerPoint 打开 图表时会从 xlsx part 读取数据源（“编辑数据” 启动 Excel）。

由 Presentation::to_opc_package 在写出 xlsx part 时自动分配； 高阶 API 创建时通常为 None，由 presentation 层填充。

Implementations

impl Chart

pub fn new(chart_type: ChartType, data: ChartData) -> Self

新建一个图表。rid 默认为空字符串，由 presentation 层在写出时填充。

pub fn parse_from_xml(xml: &str) -> Result<Chart>

从 <c:chartSpace> XML 字符串解析为强类型 Chart。

详见模块级独立函数 parse_from_xml（本关联函数是其委托）。

参数

• xml：完整 chartN.xml 内容。

错误

• Error::Xml：XML 解析失败。

impl Chart

pub fn to_xml(&self) -> String

写出 <c:chartSpace> 完整 XML（chartN.xml 内容）。

元素结构（最小可用集）

<c:chartSpace xmlns:c=... xmlns:a=... xmlns:r=...>
  <c:chart>
    <c:title>...?         ← 可选
    <c:plotArea>
      <c:layout/>         ← 自动布局
      <c:barChart|c:lineChart|c:pieChart>
        <c:barDir>...     ← 仅 barChart
        <c:grouping val="clustered"/>
        <c:ser>           ← 一个或多个系列
          <c:idx val="0"/>
          <c:order val="0"/>
          <c:tx><c:strRef><c:f>Sheet1!$B$1</c:f><c:strCache>...</c:strCache></c:strRef></c:tx>
          <c:cat><c:strRef>...类别标签...</c:strRef></c:cat>
          <c:val><c:numRef><c:numCache>...数值...</c:numCache></c:numRef></c:val>
        </c:ser>
        <c:axId val="..."/>  ← 1~2 个 axId
      </c:barChart>
      <c:catAx>...</c:catAx>     ← 类别轴（饼图无）
      <c:valAx>...</c:valAx>     ← 数值轴（饼图无）
    </c:plotArea>
  </c:chart>
</c:chartSpace>

Trait Implementations

impl Clone for Chart

fn clone(&self) -> Chart

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Chart

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

Formats the value using the given formatter.

impl Default for Chart

fn default() -> Self

默认图表：ChartType::Column + 空 ChartData + 空 rid。