python-docx官方文档翻译--用户指南10--了解图片和其他shape

了解图片和其他shape

从概念上讲，Word 文档具有两层，即文本层和绘图层。在文本层中，文本对象从左到右，从上到下排列，在上一个页面被填充时开始一个新页面。在图形层中，将图形对象（称为形状）放置在任意位置。这些有时被称为浮动 shape。

图片是可以出现在文本或绘图层中的 shape 上。当它出现在文本层中时，称为内嵌 shape，或更具体地说，称为内嵌图片。

内嵌 shape 被视为大文本字符（字符字形）。线高增加以适应 shape，并且 shape 被包装到一条线，它将适合宽度方向，就像文本一样。在其前面插入文本将导致其向右移动。通常，图片本身就是放在段落中的，但这不是必需的。它可以在其所在段落的前面和后面带有文本。

在撰写本文时，python-docx 仅支持嵌入式图片。浮动图片相关功能可能会添加。如果您有好用的用例，请在 issue 跟踪器上提交功能请求。 Document.add_picture() 方法将指定的图片添加到文档末尾的自己的段落中。但是，通过更深入地了解API，您可以将文本放在图片段落的任一侧，或同时放置在该段落的两侧。