Skip to main content

Module shape

Module shape 

Source
Expand description

形状 XML 模型:p:sp / p:pic / p:grpSp / p:cxnSp / p:graphicFrame

包含 OOXML 中所有“可视对象“的强类型表达。每个类型都自带 write_xml 方法, 按规范要求的元素顺序输出。

§与 python-pptx 的对应

  • pptx.shapes.shapetree.* ←→ Sp / Pic / Group / Connector
  • pptx.oxml.shape.* ←→ 同名 oxml 模型;
  • pptx.shapes.graphfrm.GraphicFrame ←→ GraphicFrame(承载表格/图表)。

§序列化约定

  • 非视觉属性隐藏<p:nvSpPr> 中的 cNvPr)必须最先输出;
  • spPr(几何/变换/填充/线)紧跟其后;
  • txBody(文本)最后输出;
  • 顺序错误会导致 PowerPoint 报错 “Invalid OOXML”。

Structs§

Connector
<p:cxnSp> 连接器。
ExtensionEntry
ExtensionList
扩展列表(<p:extLst>)。
GraphicFrame
<p:graphicFrame> 容器:表格、图表等使用。
Group
<p:grpSp> 组合形状。
Pic
<p:pic> 图片。
ShapeLocks
形状锁定属性(<a:spLocks>)。
ShapeStyle
形状主题样式引用(<p:style>)。
SmartArtRef
SmartArt 引用(TODO-037 最小保留)。
Sp
<p:sp> 普通形状(如文本框、矩形、椭圆等)。
StyleRef
4 个样式引用的通用结构。

Enums§

Graphic
GroupChild
LockType
形状锁定类型枚举(对应 <a:spLocks> 的 12 个属性)。
MediaKind
媒体类型(TODO-033 音视频嵌入)。