Struct TextFrame 

pub struct TextFrame<'a> { /* private fields */ }

文本框高阶视图（pptx.text.textframe.TextFrame）。

与 python-pptx 的对应

• shape.text_frame ←→ text_frame_mut().as_text_frame()（薄包装）；
• text_frame.text ←→ TextFrame::text_getter / TextFrame::set_text；
• text_frame.paragraphs[0] ←→ TextFrame::paragraphs；
• text_frame.add_paragraph() ←→ TextFrame::add_paragraph；
• text_frame.word_wrap ←→ TextFrame::word_wrap / TextFrame::set_word_wrap；
• text_frame.auto_size ←→ TextFrame::auto_size / TextFrame::set_auto_size；
• text_frame.vertical_anchor ←→ TextFrame::vertical_anchor / TextFrame::set_vertical_anchor；
• text_frame.margin_left/... ←→ TextFrame::margin_left / … / TextFrame::set_margins。

设计要点

• 借用：构造时传入 &mut TextBody；
• 零分配：所有方法均不触发堆分配；
• 互斥语义：TextFrame::add_paragraph 不会自动 trim，已有段落不会被移除。

Implementations

impl<'a> TextFrame<'a>

pub fn new(body: &'a mut TextBody) -> Self

构造。

pub fn body(&self) -> &TextBody

底层 body 不可变引用。

pub fn body_mut(&mut self) -> &mut TextBody

底层 body 可变引用。

pub fn len(&self) -> usize

段落数。

pub fn is_empty(&self) -> bool

是否为空。

pub fn paragraphs(&self) -> Iter<'_, Paragraph>

不可变段落迭代器。

pub fn paragraphs_mut(&mut self) -> IterMut<'_, Paragraph>

可变段落迭代器。

pub fn paragraph(&self, idx: usize) -> Option<&Paragraph>

按下标取不可变段落。

pub fn paragraph_mut(&mut self, idx: usize) -> Option<&mut Paragraph>

按下标取可变段落。

pub fn first_paragraph(&self) -> Option<&Paragraph>

首个段落。

pub fn first_paragraph_mut(&mut self) -> Option<&mut Paragraph>

首个段落的可变引用。

pub fn add_paragraph(&mut self) -> &mut Paragraph

新增空段落（python-pptx text_frame.add_paragraph()）。

pub fn add_paragraph_with_text(&mut self, text: &str) -> &mut Paragraph

新增带文本段落（按 \n 切分为多段），返回最后一段的可变引用。

pub fn remove_paragraph(&mut self, idx: usize) -> Option<Paragraph>

按下标移除段落。

pub fn clear(&mut self)

清空段落（保留一个空段，对应 python-pptx text_frame.clear()）。

pub fn text_getter(&self) -> String

整体取文本（段间 \n，与 python-pptx text_frame.text 一致）。

pub fn set_text(&mut self, text: &str)

整体替换文本（按 \n 切分；旧段落属性会被丢弃）。

pub fn auto_size(&self) -> MsoAutoSize

自动调整策略。

pub fn set_auto_size(&mut self, v: MsoAutoSize)

设置自动调整策略。

pub fn vertical_anchor(&self) -> Option<MsoAnchor>

垂直对齐。

pub fn set_vertical_anchor(&mut self, v: MsoAnchor)

设置垂直对齐。

pub fn word_wrap(&self) -> Option<bool>

是否自动换行（None = 走默认）。

pub fn set_word_wrap(&mut self, v: bool)

设置是否自动换行。

pub fn margin_left(&self) -> Option<Emu>

左边距。

pub fn margin_right(&self) -> Option<Emu>

右边距。

pub fn margin_top(&self) -> Option<Emu>

上边距。

pub fn margin_bottom(&self) -> Option<Emu>

下边距。

pub fn set_margins(&mut self, l: Emu, t: Emu, r: Emu, b: Emu)

一次性设置四向边距。

pub fn set_margin_left(&mut self, emu: Emu)

设置单边边距（left）。

pub fn set_margin_right(&mut self, emu: Emu)

设置单边边距（right）。

pub fn set_margin_top(&mut self, emu: Emu)

设置单边边距（top）。

pub fn set_margin_bottom(&mut self, emu: Emu)

设置单边边距（bottom）。

pub fn num_cols(&self) -> Option<u32>

文本列数（numCol 属性）。

None 表示未设置（默认单列）；Some(1) 等同于单列。

pub fn set_num_cols(&mut self, count: u32)

设置文本列数（numCol 属性）。

pub fn col_spacing(&self) -> Option<Emu>

列间距（spcCol 属性，EMU）。

pub fn set_col_spacing(&mut self, emu: Emu)

设置列间距（spcCol 属性，EMU）。

pub fn set_columns(&mut self, count: u32, spacing: Option<Emu>)

一次性设置多列布局（列数 + 可选列间距）。

对标 python-pptx 中 text_frame 的多列设置。 当 spacing 为 None 时仅设置列数，保留已有列间距。

Trait Implementations

impl<'a> Debug for TextFrame<'a>

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

Formats the value using the given formatter.

impl<'a> From<&'a mut TextBody> for TextFrame<'a>

fn from(b: &'a mut TextBody) -> Self

Converts to this type from the input type.