Struct CustomProperties 

pub struct CustomProperties { /* private fields */ }

自定义文档属性集合（/docProps/custom.xml）。

对标 python-pptx 中 Presentation.custom_properties（v1.0+）。 存储用户自定义的键值对，PowerPoint 在“文件 → 信息 → 属性 → 高级属性 → 自定义“中显示。

序列化

to_opc_package 会在 custom_properties 非空时写出 /docProps/custom.xml， 并在 _rels/.rels 中添加 custom-properties 关系。

示例

use pptx_rs::Presentation;
use pptx_rs::presentation::CustomPropertyValue;

let mut p = Presentation::new().unwrap();
p.custom_properties_mut().set("Project", CustomPropertyValue::Text("Demo".to_string()));
p.custom_properties_mut().set("Version", CustomPropertyValue::Int(42));
p.save("out.pptx").unwrap();

Implementations

impl CustomProperties

pub fn new() -> Self

创建空的自定义属性集合。

pub fn is_empty(&self) -> bool

是否为空。

pub fn len(&self) -> usize

返回条目数。

pub fn set(&mut self, name: impl Into<String>, value: CustomPropertyValue)

设置（或覆盖）一个自定义属性。

参数

• name：属性名（不可为空）；
• value：属性值。

pub fn get(&self, name: &str) -> Option<&CustomPropertyValue>

取指定名称的属性值。

pub fn remove(&mut self, name: &str) -> Option<CustomPropertyValue>

移除指定名称的属性。

返回被移除的值（若存在）。

pub fn iter(&self) -> impl Iterator<Item = (&str, &CustomPropertyValue)>

返回所有条目的迭代器。

pub fn to_xml(&self) -> String

序列化为 /docProps/custom.xml 的 XML 字符串。

XML 结构

<Properties xmlns="...custom-properties" xmlns:vt="...docPropsVTypes">
  <property fmtid="{D5CDD505-...}" pid="2" name="Key1">
    <vt:lpwstr>Value1</vt:lpwstr>
  </property>
  ...
</Properties>

pid 从 2 开始（1 保留给 SummaryInformation）。

pub fn from_xml(xml: &str) -> Self

从 /docProps/custom.xml 的 XML 字符串解析。

参数

• xml：custom.xml 的完整内容。

返回值

解析出的 CustomProperties。解析失败的条目会被跳过（不中断整体解析）。

Trait Implementations

impl Clone for CustomProperties

fn clone(&self) -> CustomProperties

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CustomProperties

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

Formats the value using the given formatter.

impl Default for CustomProperties

fn default() -> CustomProperties

Returns the “default value” for a type.