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>连接器。- Extension
Entry - Extension
List - 扩展列表(
<p:extLst>)。 - Graphic
Frame <p:graphicFrame>容器:表格、图表等使用。- Group
<p:grpSp>组合形状。- Pic
<p:pic>图片。- Shape
Locks - 形状锁定属性(
<a:spLocks>)。 - Shape
Style - 形状主题样式引用(
<p:style>)。 - Smart
ArtRef - SmartArt 引用(TODO-037 最小保留)。
- Sp
<p:sp>普通形状(如文本框、矩形、椭圆等)。- Style
Ref - 4 个样式引用的通用结构。
Enums§
- Graphic
- Group
Child - Lock
Type - 形状锁定类型枚举(对应
<a:spLocks>的 12 个属性)。 - Media
Kind - 媒体类型(TODO-033 音视频嵌入)。