Struct TextBox 

pub struct TextBox { /* private fields */ }

文本框（python-pptx 的 shapes.add_textbox 对应）。

Implementations

impl TextBox

pub fn new(name: impl Into<String>) -> Self

新建一个文本框。

pub fn from_sp(sp: OxmlSp) -> Self

从 oxml OxmlSp 构造。

pub fn text_frame(&self) -> &TextBody

文本帧不可变引用。

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

文本帧可变引用。

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

替换全部文本（每行一个段落）。

替换后旧的 Run 属性（字体、颜色、加粗）会被清除；如需保留请直接操作 TextBox::text_frame_mut。

pub fn text(&self) -> String

取文本（把全部段落拼起来，行间 \n）。

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

单词换行便捷方法。

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

自动调整便捷方法。

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

垂直对齐便捷方法。

pub fn set_outer_shadow(&mut self, shadow: ShadowEffect)

设置外阴影（<a:outerShdw>）。详见 crate::shape::AutoShape::set_outer_shadow。

pub fn set_inner_shadow(&mut self, shadow: ShadowEffect)

设置内阴影（<a:innerShdw>）。详见 crate::shape::AutoShape::set_inner_shadow。

pub fn set_glow(&mut self, glow: GlowEffect)

设置发光（<a:glow>）。详见 crate::shape::AutoShape::set_glow。

pub fn set_soft_edge(&mut self, rad: i64)

设置柔化边缘（<a:softEdge>）。详见 crate::shape::AutoShape::set_soft_edge。

pub fn set_reflection(&mut self, reflection: ReflectionEffect)

设置反射（<a:reflection>）。详见 crate::shape::AutoShape::set_reflection。

pub fn clear_effects(&mut self)

清除所有效果。详见 crate::shape::AutoShape::clear_effects。

pub fn set_3d_rotation(&mut self, lat_deg: f64, lon_deg: f64, rev_deg: f64)

设置三维旋转。详见 crate::shape::AutoShape::set_3d_rotation。

pub fn set_3d_extrusion(&mut self, height_emu: i32, color: Option<Color>)

设置三维拉伸。详见 crate::shape::AutoShape::set_3d_extrusion。

pub fn set_3d_bevel( &mut self, top_w: i32, top_h: i32, bottom_w: i32, bottom_h: i32, )

设置三维棱台。详见 crate::shape::AutoShape::set_3d_bevel。

pub fn set_3d_material(&mut self, material: MaterialPreset)

设置三维材质预设。详见 crate::shape::AutoShape::set_3d_material。

pub fn clear_3d(&mut self)

清除所有三维效果。详见 crate::shape::AutoShape::clear_3d。

pub fn scene_3d(&self) -> Option<&Scene3d>

取三维场景引用。详见 crate::shape::AutoShape::scene_3d。

pub fn scene_3d_mut(&mut self) -> &mut Option<Scene3d>

取三维场景可变引用。详见 crate::shape::AutoShape::scene_3d_mut。

pub fn sp_3d(&self) -> Option<&Sp3d>

取形状三维属性引用。详见 crate::shape::AutoShape::sp_3d。

pub fn sp_3d_mut(&mut self) -> &mut Option<Sp3d>

取形状三维属性可变引用。详见 crate::shape::AutoShape::sp_3d_mut。

pub fn locks(&self) -> Option<&ShapeLocks>

读取形状锁定（<a:spLocks>）。详见 crate::shape::AutoShape::locks。

pub fn locks_mut(&mut self) -> &mut ShapeLocks

读取形状锁定的可变引用。详见 crate::shape::AutoShape::locks_mut。

pub fn lock_select(&mut self, locked: bool)

便捷锁定：禁止选中。详见 crate::shape::AutoShape::lock_select。

pub fn lock_move(&mut self, locked: bool)

便捷锁定：禁止移动。详见 crate::shape::AutoShape::lock_move。

pub fn lock_resize(&mut self, locked: bool)

便捷锁定：禁止缩放。详见 crate::shape::AutoShape::lock_resize。

pub fn lock_rotate(&mut self, locked: bool)

便捷锁定：禁止旋转。详见 crate::shape::AutoShape::lock_rotate。

pub fn lock_group(&mut self, locked: bool)

便捷锁定：禁止组合。详见 crate::shape::AutoShape::lock_group。

pub fn clear_locks(&mut self)

清除所有锁定。详见 crate::shape::AutoShape::clear_locks。

pub fn set_lock(&mut self, lock_type: LockType, locked: bool)

统一锁定入口：按 crate::LockType 设置指定锁定。 详见 crate::shape::AutoShape::set_lock。

pub fn style(&self) -> Option<&ShapeStyle>

读取主题样式引用（<p:style>）。详见 crate::shape::AutoShape::style。

pub fn set_style(&mut self, style: ShapeStyle)

设置主题样式引用。详见 crate::shape::AutoShape::set_style。

pub fn clear_style(&mut self)

清除主题样式引用。详见 crate::shape::AutoShape::clear_style。

Trait Implementations

impl Clone for TextBox

fn clone(&self) -> TextBox

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextBox

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

Formats the value using the given formatter.

impl Default for TextBox

fn default() -> TextBox

Returns the “default value” for a type.

impl Shape for TextBox

fn id(&self) -> u32

形状唯一 ID（在所属 slide 内）。

fn set_id(&mut self, id: u32)

设置 ID。

fn name(&self) -> &str

形状名。

fn set_name(&mut self, name: String)

设置形状名。

fn shape_type(&self) -> &'static str

形状类型（如 "text_box" / "picture" / …）。

fn left(&self) -> Emu

左上角 x（EMU）。

fn set_left(&mut self, emu: Emu)

设置左上角 x。

fn top(&self) -> Emu

左上角 y（EMU）。

fn set_top(&mut self, emu: Emu)

设置左上角 y。

fn width(&self) -> Emu

宽（EMU）。

fn set_width(&mut self, emu: Emu)

设置宽。

fn height(&self) -> Emu

高（EMU）。

fn set_height(&mut self, emu: Emu)

设置高。

fn rotation(&self) -> f64

旋转角度（度数，正向顺时针）。

fn set_rotation(&mut self, deg: f64)

设置旋转角度。