Skip to main content

FormatScheme

Struct FormatScheme 

Source
pub struct FormatScheme {
    pub name: String,
    pub raw_xml: String,
    pub fill_styles: Vec<String>,
    pub line_styles: Vec<String>,
    pub effect_styles: Vec<String>,
    pub bg_fill_styles: Vec<String>,
}
Expand description

格式方案(对应 <a:fmtScheme>)。

FormatScheme 包含 fillStyleLst / lnStyleLst / effectStyleLst / bgFillStyleLst, 每个都含有复杂的嵌套元素(gradFill / ln / effectLst / scene3d / sp3d 等)。

§结构化策略

采用适度结构化:保留 raw_xml 用于 round-trip,同时把 4 个 style 列表 拆分为 fill_styles / line_styles / effect_styles / bg_fill_styles, 每个元素是对应子元素的原始 XML 字符串(如 <a:gradFill>...</a:gradFill>)。 这样用户可以查询/替换某个 style,而无需完整解析每个 fill/ln/effect 的内部结构。

Fields§

§name: String

格式方案名(<a:fmtScheme name="Office">)。

§raw_xml: String

原始 XML 内容(<a:fmtScheme> 内部的子元素 XML)。

为空时 Theme::to_xml 会使用默认的 Office 格式方案。

§fill_styles: Vec<String>

填充样式列表(<a:fillStyleLst> 内的每个 fill 元素 XML)。

通常 3 个:solidFill / gradFill / gradFill。

§line_styles: Vec<String>

线条样式列表(<a:lnStyleLst> 内的每个 <a:ln> 元素 XML)。

通常 3 个。

§effect_styles: Vec<String>

效果样式列表(<a:effectStyleLst> 内的每个 <a:effectStyle> 元素 XML)。

通常 3 个。

§bg_fill_styles: Vec<String>

背景填充样式列表(<a:bgFillStyleLst> 内的每个 fill 元素 XML)。

通常 2 个。

Implementations§

Source§

impl FormatScheme

Source

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

写出 <a:fmtScheme> 元素到 writer。

优先级:结构化字段(fill_styles 等)> raw_xml > 默认 Office 格式方案。 若结构化字段非空,按 OOXML 顺序输出 4 个 style 列表;否则回退到 raw_xml。

Source

pub fn parse_from_raw_xml(&mut self)

从 raw_xml 解析填充 4 个结构化字段(fill_styles / line_styles / effect_styles / bg_fill_styles)。

解析后结构化字段非空,后续 write_xml 会优先使用结构化字段。 若 raw_xml 为空,此方法不做任何操作。

§解析策略

使用简单字符串查找定位 4 个 <a:xxxStyleLst> 容器,然后收集每个容器的 直接子元素 XML。不解析子元素的内部结构(如 gradFill 的 gsLst),保留原始 XML。

Source

pub fn fill_style_count(&self) -> usize

填充样式数量。

Source

pub fn line_style_count(&self) -> usize

线条样式数量。

Source

pub fn effect_style_count(&self) -> usize

效果样式数量。

Source

pub fn bg_fill_style_count(&self) -> usize

背景填充样式数量。

Trait Implementations§

Source§

impl Clone for FormatScheme

Source§

fn clone(&self) -> FormatScheme

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for FormatScheme

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for FormatScheme

Source§

fn default() -> FormatScheme

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V