Struct LayoutDef 

pub struct LayoutDef {
    pub unique_id: Option<String>,
    pub title: Option<String>,
    pub desc: Option<String>,
    pub categories: Vec<LayoutCategory>,
    pub layout_node_xml: String,
}

SmartArt 布局定义（layout part 的半结构化表达）。

对应 /ppt/diagrams/layoutN.xml 的 <dgm:layoutDef> 根元素。 布局定义描述了 SmartArt 图形的拓扑算法（如线性/层次/循环/矩阵）， 是 SmartArt 的“模板“。

半结构化策略

layoutNode 算法树结构复杂（含 alg/forEach 嵌套），本结构仅提取顶层元数据 （uniqueId / title / desc / catLst），layoutNode 子树保留原始 XML。

Fields

unique_id: Option<String>

唯一 ID（uniqueId 属性，用于跨 pptx 引用同一布局）。

title: Option<String>

标题（<dgm:title val="..."/>）。

desc: Option<String>

描述（<dgm:desc val="..."/>）。

categories: Vec<LayoutCategory>

类别列表（<dgm:catLst>/<dgm:cat>）。

layout_node_xml: String

layoutNode 子树原始 XML（<dgm:layoutNode>...</dgm:layoutNode> 整段）。

保留 byte-exact，避免重新序列化复杂的算法树。

Implementations

impl LayoutDef

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

从 <dgm:layoutDef> XML 字符串解析为 LayoutDef。

解析策略

• 提取 <dgm:layoutDef> 的 uniqueId 属性；
• 提取 <dgm:title val="..."/> 与 <dgm:desc val="..."/> 的 val 属性；
• 提取 <dgm:catLst> 下的所有 <dgm:cat> 的 type 与 pri 属性；
• 把 <dgm:layoutNode> 整段切片为 layout_node_xml（byte-exact）。

错误

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

pub fn to_xml(&self) -> String

把 LayoutDef 序列化为 <dgm:layoutDef> XML 字符串。

layoutNode 子树通过 layout_node_xml 直接透传。

Trait Implementations

impl Clone for LayoutDef

fn clone(&self) -> LayoutDef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LayoutDef

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

Formats the value using the given formatter.

impl Default for LayoutDef

fn default() -> LayoutDef

Returns the “default value” for a type.