Struct DataModel 

pub struct DataModel {
    pub points: Vec<DataModelPoint>,
    pub connections: Vec<DataModelConnection>,
}

SmartArt 数据模型（data part 的结构化表达）。

对应 /ppt/diagrams/dataN.xml 的 <dgm:dataModel> 根元素。 一个 SmartArt 图形的所有节点（pt）与连接（cxn）都在这里—— 这是 SmartArt 的核心数据，编辑/查询节点都基于此结构。

结构示例

<dgm:dataModel xmlns:dgm="..." xmlns:a="...">
  <dgm:ptLst>
    <dgm:pt modelId="0" type="doc"/>
    <dgm:pt modelId="1" type="par">
      <dgm:prSet ang="0"/>
      <dgm:spPr/>
      <dgm:t><a:bodyPr/><a:lstStyle/><a:p><a:r><a:t>根节点</a:t></a:r></a:p></dgm:t>
    </dgm:pt>
  </dgm:ptLst>
  <dgm:cxnLst>
    <dgm:cxn type="parChld" srcId="1" destId="2"/>
  </dgm:cxnLst>
</dgm:dataModel>

Fields

points: Vec<DataModelPoint>

节点列表（<dgm:ptLst>/<dgm:pt>）。

connections: Vec<DataModelConnection>

连接列表（<dgm:cxnLst>/<dgm:cxn>）。

Implementations

impl DataModel

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

从 <dgm:dataModel> XML 字符串解析为强类型 DataModel。

参数

• xml：完整 dataN.xml 内容（含 <?xml?> 声明与 <dgm:dataModel> 根元素）。

返回值

• 成功：返回 DataModel，包含所有节点与连接。
• 失败：返回 Error::Xml，包含解析错误上下文。

解析策略

使用 quick-xml SAX 事件流解析：

• 进入 <dgm:pt> 时收集属性（modelId / type），开始累积 raw_xml；
• 在 <dgm:pt> 内的 <a:t> 文本事件提取节点文本；
• 离开 <dgm:pt> 时把累积的 raw_xml 切片写入 point.raw_xml；
• <dgm:cxn> 类似处理。

错误

• Error::Xml：XML 解析失败（畸形 / 未闭合等）。

pub fn to_xml(&self) -> String

把 DataModel 序列化为 <dgm:dataModel> XML 字符串。

注意：本方法用于“从结构化模型重建 XML“场景；如果只是 round-trip， 应直接使用 crate::presentation::DiagramEntry 持有的 data_xml 字段。

输出结构

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dgm:dataModel xmlns:dgm="..." xmlns:a="...">
  <dgm:ptLst>
    <!-- 每个 point 的 raw_xml 直接透传（保留 byte-exact） -->
  </dgm:ptLst>
  <dgm:cxnLst>
    <!-- 每个 connection 的 raw_xml 直接透传 -->
  </dgm:cxnLst>
</dgm:dataModel>

设计要点

节点/连接的子元素（<dgm:prSet> / <dgm:spPr> / <dgm:t> 等）通过 raw_xml 字段直接透传，避免重新序列化时丢失属性。

结构化重建分支

当 raw_xml 为空但 text 字段非空时（用户新建的节点），按 OOXML 顺序 构造完整 <dgm:pt> 结构：

<dgm:pt modelId="..." type="...">
  <dgm:t><a:bodyPr/><a:lstStyle/><a:p><a:r><a:t>文本</a:t></a:r></a:p></dgm:t>
</dgm:pt>

这是为了支持“从零构造 SmartArt 数据模型并写出“的场景。

pub fn point_mut(&mut self, model_id: u32) -> Option<&mut DataModelPoint>

按 model_id 查找节点，返回可变引用。

便捷方法：避免外部遍历 points 列表。未找到返回 None。

pub fn point(&self, model_id: u32) -> Option<&DataModelPoint>

按 model_id 查找节点，返回不可变引用。

pub fn set_point_text( &mut self, model_id: u32, new_text: impl Into<String>, ) -> bool

设置指定 model_id 节点的显示文本（便捷方法）。

内部调用 DataModelPoint::set_text。未找到节点返回 false， 成功修改返回 true。

Trait Implementations

impl Clone for DataModel

fn clone(&self) -> DataModel

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DataModel

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

Formats the value using the given formatter.

impl Default for DataModel

fn default() -> DataModel

Returns the “default value” for a type.